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Eddy Awctrd Winner for Best New Developer Tool 

- MttcUser Editors Choice Awanh, 1993 

“A distinct improvement over ResEdiL"" 

- MacTech IMacTiior 

^Resorcerer^s data template system is amazingr 
-Bill GoodmaUj author of Compact Pro 

""Nuke ResEdit! Resorcerer is mission-critical for us” 

- Dave Winer^ Userland Frontier 

*^he color pixel editors are wonderful! A work of art!” 

— Dave Winzler^ author of Microseeds Redux 

""Every Macintosh developer should own a copy of Resorcerer ” 

- Leonard Rosenthof Aladdin Systems 

""Resorcerer will pay for itself many times over in saved time and effort 
-MacUser review 

""The template that disassembles PICPs is awesomer 

- Bill Steinberg, author of Pyro! and PBTooLs 

“Resorcerer proved indispensible in its own creation!” 

—Doug McKenna, author of Resorcerer 

“...a wealth of time-saving tools.” 

MiicUser Review^ Dec. 1992 



Version 1.2.4 


The Resource Editor for the Macintosh Wizard 


OaOERING INFO 


Needs: ^ac Plus, > Sys 4,2, 1MB 
Likes: Plus, S Sys 7.0, 2MB 

32-bit clean, AU/X compatible 

Price: $256 (decimal) 
(Educational, quantity, or 
other discounts available) 

Includes: 500 page manual 
60-day Money-Back Guarantee 
Domestic UPS ground shipping 

Pa3mnent: Check, PO's, or Visa/MC 

Extras (call us): 

COD, FedEx, UPS Blue/Red, 
International Shipping 


Downloadable Demoa/Updaters: 

AppleLink: Software Sampler 
AOL: Software Libs/Development 
CompuServe: MACDEV/Ibols 
or call us. 


• New ‘cicn’, ‘ppap, ^ersr*, ‘acur’, ‘pltP, 'cluP editors 

• Powerful icon family editing (all 9 icon types) 

• Color pixel anti-aliasing, dithering, and lots more 

• Complete T^ICT’ disassembly and reassembly 
New 1>2 Features: • Resource sorting; ROM resource browsing 

• 120 template field parsing types now supported 

• New insertion & deletion template field types 

• Tbxt-only ‘PTCF resources 

• Lots of improvements throughout 

• Easier, faster, more Mac-like, and more productive than ResEdit 

• Safer memory-based, not disk-file-based, design and operation 

• All file information and common commands in one easy-to-use window 

• Compares resource files, and even edits your data forks as well 

• Visible, accumulating, editable scrap 

• Searches and opens/marks/sclects resources by text content 

• Makes global resource ID or type changes easily and safely 

• Builds resource files from simple Rez-like scripts 

• Most editors DeRez directly to the clipboard 

• All graphic editors support screen-copying or partial screen-copying 

• Hot-linking Value Converter for editing 32 bits in a dozen formats 

• Its own 32-bit List Mgr can open and edit very large data structures 

• Templates can pre- and post-process any arbitrary data structure 

• Includes nearly 200 templates for common system resources 

• TMPLs for Installer, MacApp, QT, Help, AppleEvent, OCE, GX, etc, 

• Full integrated support for editing color dialogs and menus 

• Try out balloons, ^ietb’s, lists and popups, even create C source code 

• Integrated single-window Hex/Code Editor, with patching, searching 

• Editors for cursors, versions, pictures, bundles, and lots more 

• Well-designed, helpful developer tools being added all the time 

• Relied on by thousands of Macintosh developers around the world 


MATHEM^TSSTHETICS, INC. 

P.0, Box 298 • Boulder • CO • 80306-0298 • USA 
Phone; (303) 440-0707 • Fax:(303)440-0504 
AppleLink/AmericaOniine: RESOKCERER • Inlemet: resorcererSaol.cum 
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o I have to use a FC 
to port Windows applications to a Mac? 


WILLOWS TWIN APIW for Macintosh 
Windows API tool box extension 
for Macintosh developers 


• Multi-platform implementation of the Windows API 

• Works with Macintosh tools and compilers 

• Native library optimized for PowerPC or 68K 

• Work within the IDE of your choice 



Call now: (408) 777-1820 
Visit our web site: http://www.willows.com 


W I 1 1 0 W 5 Willows Software*, Inc. 12950 Saratoga Avenue, Suite A, Saratoga, CA 95070 
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In this electixinic age, ihc art of 
commonicaiion lias bccojne Ixjth easier and 
more compliatled. Is it any SLirprLse that we 
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Hy Erie Gundrum 




Tiu: Mac \s a Gamf. Machine 

Bijrk when the Mac %vaH just starting out it was heavily 
detidcxl as just a toy, a niiichine^ hy the business Iblks w^ho 

didn't want to see llte Mac encnrach on their contix)! of cotnputing 
pow't*r, 1hese are the ixsiplc who thought using a computer had 
to Ixf lurrd work if the cfjmputer was cajyablc of working hard. 
'Die Mac, willi its smiling arceptance of a flt>ppy disk, ils liigli 
ciuality graphics, its aisc^ oj‘ use, jtist couldn't lx anything but a 
game machine; it w'as tex) ntuch fun! 

Apple fouglit long and hard against that stigma. Tliey 
ostraeij^ed games developc'i^, driving all l)ui the most deteniiined 
of them to other platforms. It locjk Ap[)[e .st^veml years, biit they 
were successful Macs had made it into the big time, with full 
corporate accepiance, anti very few games. The Macintosh 
community liad invetited desktop publishing. 

With st> ni^iny businestses s(X)n using Mat's, jx-ople Ixgan to 
take uolice tjf just how much fun it wus to use tills little computer. 
After all, what oilier compiMing platform had Hying Utasters, and 
with Opus to .shoot them tlown? l>esklop entertainment was bom, 
and ils mother w;is Madnttxsh. Still, Apple in,sisitxl that the Mac 
was not a game machine. 

Several more years passetf and the Macintosh cumniuniiy 
grtw larger Many txw' llavors ol' Macintosh wert^ now available, 
each Itsier ihao its prtxleccssor, with hmey color st retais, CI TKOM 
drives and videcj in and out. Still, it wiisn't a game machine. Sure 
there were a lew games avxiilahle, often lucked aw'ay as sueen 
saver modules or pt>orly implemented pons from another 
piaifonn, Yet ncjiie of ihc.Si* [programs really t(X)k advantage of the 
tintc|ue features of the MatiTTltxsh, and leatures like multi-channel 
slerLX) sound had Ixxn with the Mac’ for several ycxirs. 

Tinally, willi ihe advent <af the PowerMac, Ai>ple .started lo 
[\ixvp\ tlrti people wiinied U> [ilay s^imt»,s, and they wanted to do so 
with their Mac. A Few games ap]X"artxl to expk>a' thc^ |X>wct of tllY 
ROM, .stereo sound, ,su|X'ii> graphics and PcjwerPC], Howecer, liie 
Macintfjsh wus still not the f^latfomi of dxace for game develo|x*ix 

Yet more time pa,ssed. The Mac h:Ls btx^n puslied aside by 
some tjf ihe mort^ short-.sighied business folks, hut Apple — yes, 
Apple — lias finally .siki lli^it the Mac tea game madiine. 

Game Smot^KETS, a Great Idea 

With the advent of Apple's Game Sprcxkeis, A)>()le pmvided 
game develojxrs a set of lools making programming quality games 
for Maeintosh easy, providirig access to die Mac’s pow^erful 
multimedia capabilities while helping the games IxTome more 
coasLsteni and reliable. 

As you will undoubtedly see hrom nt^ading the articles in itiis 
issue, Applt^^s Game Sprcxkels are a powerful tcxjl. lliey provkle 


simple and reliable access to double buffered animation, multi' 
cliannel stereo sound, protcxxil independent network gaming, and 
sup]X)rt ftx an infinite vanely of input devices. Game ^iprockels also 
liantile much of the mundane user interface to .set Macintosh 
hardw'ure options, including dicxising an input device, display 
device and network players. Add in the many inacdilile mulLimedia 
technologies already available on the Mac, and the Mac’mtosh 
piaifonn Ixcomes one heck of a cooi g^uix machine. 

But, Why Support Games? 

Some people complain ihai Ap[)lc slunikln't waste resources 
on foolish filings like helping game developut's. The icaliiy is that 
people love playing games. People are often so fasdnaled l>y 
('omputcr games that tliey will play them repeatedly tor several 
(xjurs and nut realize whem their lime lias gt>ne. 

Games generally demoasirate moa^ creativity than any other 
scjftware genre. Often they push the limits of the computers 
capabilities Ix'yond wheie anyone llioughi iliey cxxikl go. It is more 
likely thai gtmes are responsible for ilie existence of lOx speed CD- 
ROM drive tlian is kKjking up phone numixni. Tlx Mac has had very 
few new input devices, bui Apple’s Input Spixxket mikes tlx |Xjrting 
of innovative input biRlwaie fnxn other plaltdnus much easier, and 
increases ihc size of tlx ptxenrial market. 

Look carerully at the technology of Game Spnxkcts. Is it 
really for use only in games? Tlie input devices could lx used in a 
variety of iniemctive muklmedia applications. There is nothing 
aboLii the piaifonn intlefxmdent, dient-.server nelwt^rk capal:)ililies 
that checks for alien invader information in the exchanged 
iiiessage.s. Don hie-buffered video lias been used for years to 
accelerate many gniphics applications; now ii is more reliable. 
Game Sprtxkets may make ihc^^ and other cipabilities much 
ea.sicr even for non-entertainment api^lications. 

In This Issue 

In tills Issue we offer two new- Macintosh games, complete with 
.source txxle. Try ’em; if you duiYt like them, well, you have the 
.st:)urces, fix diem io work rlx way you diink diey slicxild work. 

iiii.s issue also include.s an ariicle suggesting how to 
implemeni serializ;Hion of your afiplication, making network- 
Irjsed fxtxiuct disiribution more profitable. For lliose of you siill 
learning the basics, W'c include an article clescTihing how to use 
the Resource Manager. If you are keen on communications 
lechnologies, chec k out the game article built around the ii.se of 
the Communications T(K>lbox. 

With ail this cool tedmtjlogy, the excuses for so few Mac 
games are dwindling, I Ux>k fonvard lo many new txx>l apps to 
chix>.sc from by next holiday shopping sea.son, W 
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MORE DEVELOPERS PROIECT. 




MacHASP Packs 
More Into Less. 

Biised on slate-of-tiie-art ASIC technology, 
MacHASP packs the inJiistry 's most 
advanced security, compatibility and 
flexibility into a compact and end-user- 
friendly dongle. 

Grow With Aladdin! 

The fastest growing company 
in the industry, with over 4 
million keys sold to 20 
thousand developers 
worldwide, Aladdin is setting 
the standard for software security today. 

NSTL Study Rates 
HASPNo.1! 

A recent test conducted by the National 
.Software Testing latbs ’, the world’s foremost 
independent lab, compared tlie flagsliip PC 
pnxlucLs of leading software protection 
vendois. The result? HASP was rated die dear 
overall winner - and number one in all the 
major comparison categories. For a full copy 
of the NSTI. report, contact your locsd 
HASP distributor, 



MacHASP 
PROTECTS 
MORE. 


Mac'OS 

These days, more and more developers are choosing to protect their software against 
piracy. Tliey're protecting more produces, on more [ilatfomis, with better protection • 
and selling more as a result. 

And more of these develojiers are protecting with MacHASP, Why? 

Because MacHASP offers more security, more reliability and more 
features than any other product on the market. Only MiicHASP offers 
capabilitiassuch as network support, anti-debugging envel()p<; 
protection, and secure remote activation and U[idating. 

MacHASP supports the most advanced piatforms, including all 
versions of MacOS and Power Mac - as well <ls AppleTalk 
networks. And because Aladdin is a licensed Apple Partner, 

MacHASP guarantees full, transparent compatibility 
with the ADB standard. 

To learn more about how you can protect 
Iretter - and sell more - call now to order 
your MacHASP Developer’s Kit. 
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1-800-223-4277 
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North America Aladdin Knowled^fi: Systems tnc. Tl:|r (8U0S Ui 4277,1I2’564 567H. Fajc 212 5577, H-niaJI: coin 

Int’l Office Aladdin Knowledge Systems Ltd. Tcl 2222.+972 5 457 5796, L riutil: aiiii 

Oerma ny FAST Software Sac uilty AG M t Vf) H9 41 21 57, 1 49 42 21 -iO, K jntil I- i i iU ng tip 

United Kingdom Aladdin Knowledge Systems UK Ltd, Td“ +44 175,4 fi222fi6, i^sixr 1 44 1755 621262. h: tn;til: 

Japan Aladdin Japan Co.^ Ltd. M i HI 426 607191. ras: + Kl 426 6(17194. K nih]l;s:ili^O^VaE;Mlflin.m.||i 

Beneluit Aladdin Software Security Bonelun B.V. +51 24 64 i 9777. +31 24 f)45 !9H1. K+n!i!l; 100526.15564f4D!)iii(Hiserwje(jiii 


ALADDIN 


The Professional's Choice 
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By Dave Mark 


The ShapeWorld Applet 



A few months ago I promised an applet tliat 
did dtHit)]e'[>uffered animation. When I 
started work on llic sample applet, 1 realized 
that I was definitely jumping the gun and 
there was still a lot of gK)und to cover to get 
to double-buffering. Since then, JVe 
explored the AWT event-handling 
mechanism, as well as the various shape 
drawing routines in the Gniphics class. 

This month I am going to bring these 
concei:)ts (and a few new ones ) togetlier into 
an applet called ShapeWorld. Ihis montlTs 
version of SliapeWtjrld (ril extend it next 
month) randomly scatters some rcetangles 
into a Cajivas, tlien responds to mouse dicks 
by seleoing and desc*lecting the lectangles. As 
you'll see next month, ShapeWorld was 
designed to l^e extended. For now, let's gel 
the first version up and running. 

Thf. ShapeWori.d Project 

Liunch the CcxleWL^rrior IDF and create 
a new' pniject named ShapeWorldji using tJie 
Java applet sUUioncry. Create a new source 
file mimed ShapeWorld.java and add it to tlie 
project, Here’s the ShapeWorld, java source 
c(xlc: 


import java.awt.*: 
iinport jav'a.util,": 


boundsRect = new Rectanglet x, y. width, height ); 


abstract public void drawC Graphics g ): 

public void setHighIight( boolean nowHighllght ) 

1 

highlighted = newhighlight: 

I 

public boolean isHighlightedO 
I 

return highlighTed; 

I 

public boolean isFointiuShape( int x. int y ) 

[ 

return boundsRect,ineide( x, y ): 

I 


class KcciShupe extends Shape 

I 

RectShape[ ShapeCanvas canv. int x, int y. 

int width* int height ) 

[ 

super( canv. x. y. width, height ); 


public void drawt Craphics g J 

I 

if ( isHighlightedO ) 

I 


g*setColer( Color.black ); 

g.flllRcCL( shapeX. sbapeY, shapeWidth, shapeHeight 

g,sctColorC Color.red ): 

g*flllRect( shapeX+2. sbapeY+2, 

shapeWidth-4. shapeHeight-4 ); 

I 

else 

I 


g.GetCci1or( Col or* red )\ 

g.fillRectf shapeX. shapcY. shapeWidth* shapeReigbt ); 


abstract class Shape 


I 


boolean highlighted; 

ShapeCanvas shapeCanvas: 
ini shapeX. shapeY, shapeWidth* 

shapeHeight: 

Rectangle boundsRect; 

Shape[ ShapeCanvas canv* int x. Ini y, 
int width* int height ) 
i 

shapeCanvas = canv; 
highlighted ^ false; 

shapeX ^ x; 
shapeY = y: 
shapeWidth ^ width; 
shapeHeight “ height; 


class ShepeCanvas extends Canvas 

t 

Vector shapes; 

Shape curShape; 

ShapeCanvast int width, int height ) 

I 

shapes - new Vector(); 
curShape = nul1; 

setflackgroiind ( Color .yellow ) : 

resize( width* height ); 

1 


The Shaj^eWorli:) Applet 
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Purify on Unix 
Bounds Checker on Windows 
Now, from the makers of QC, comes... 
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SFOTLIQnT 


On Macintosh 


Find Bugs Fast 

Sptulighf is the first Auttimatii: MtMntiry Debugger for the 
Mricimush. Insimitly dctecc invalid memory accesses^ bad 
ltx)lbtix parameters, leaks, stack overwrites, memt^ry rt'kx-ii' 
tion pndilems, and much more. 

Spotlight uses yiJur XSYM file to automatically patch your 
application no need to change your source ctxk. No need 
to recompile. No learning curve whatsoever. 

Tht* interf:Kte gives you iastant feedlTack when an error is 
del ected. You can ignore the error, ignore all futrjre occurrences 
of the error, ot k>g the eaor to a text file for later analysis. 

Fine Grained Memory Protection 

Spotlight identifies reads and writes outside of the applicii- 
cion and system heap. Fkit it dtxfs nor stop rliere. Spot I igl it's 
tYhjtx’.r C^^xle Replacemein itrstrumentiition inspects each read 
and write instruction in your code, detecting faulty memory 
reads and writes that cKcur between blocks, in released hKx:ks, 
across rmilriple hltKiks, ai^d in ROM. 

Tiiis technology w^irks on any heap object you can allo¬ 
cate: Mac heap objects, C'malk>c' heap ohjeers, even C++ 
objects croanxl with new. 

S|Haligh< st<J|w your application whenever a faulty memory 
access is ahtuit to occur and displays the exact source code 
line where it will happen. The calling .stack is si town along 
wirlt a tlisplay of all variables. A memor>^ viewer shows the 
erroneous memory iiddress and contents. 

Toolbox Validation 

S|xxliglu checks parameters to over 400 toolbox API calls, 
automiltically validating handles, memory bliK:ks, return vah 
Lies, and st^ on. Specific checks catch subtle errois such as draw¬ 
ing into an uiikx:ked GWorld, passing an invalid window 


[X)iiuer, passing an address within an unlocked handle to a 
routine tliat may move memory, and tot> many more to lisr. 

Leak Detection 

No more stniggUng with MacsBug, On prt>gram exit Spot- 
light provides a clear listing of all leaked memory showing a 
full stack irace from where ihe memory was allocated, instantly 
di.scover all leaked Mac OS objects, mallocM i^bjccts, 
C++ objects, and resources. 

limitations 

Spi'itlight requires an XSYM file to funcrion. MPW and 
Code Warrior users c.an generate these direcily. Symantec us¬ 
ers must use Tix>lServer to link with an XSYM capable linker. 
Spotlight requires a lY'iwerlC proccssim 

Spotlight works on the object axle. No source code Ls re¬ 
quired: jusT the thing for testing purchased diirtl piirty libraries. 

Availability and Pricing 

pricing for Spotlighr l^R 1 is $ 199 US {plus $5 shipping and 
handling widiin die continental US, $15 for international 
orders). This includes a free upgrade rt> rht: GM version and 
access to ftp interim iipgratles leading up to GM. QC users can 
cross-grade to Sixiilight for only $149. 

All Onyx products cany a 50 day no quesi ion.s asked money 
hack guarantee. 

Onyx technology, Inc. 

7811 27th Avenue West 
Bradenton, Florida 54209 

salesISbnyx - tech .com wwwa m y x ^ tech .a an 

941 795-7801 941 795-5901 (tax) 



Sfpntll^dn' fmJ QC!: jme rTiiKlimidrk5 stt Qnvx Techtn^InKy. Itic Alt cuht'^r inttlunyfb im’ jTT,ifn-Fi¥ 'it owrHM% 
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X Q; What does It take to deploy a 

Q superior client/server application? 

• A SUPERIOR SERVER 

Z ’ 

m 
a 
0 

00 
00 


START with the 
most advanced client- 
side SDK on the 
market: c-tree^ Plus 
at $895, 

* Complete Source ciKle 

• ROYALTY FREE 
[CTienL Side) 

* Multiple supported 
prolucoLs 

* FiiSt, portable, reliable 

• Powerful feiitiires like 
transaction prtjcessing 

• Win95, NT, ynd 

Windows 3.1 leady 

^ ni I 

ADD a strong, 
multhplatform, 
industrial-strength 
Server that support^ 

* F’Ele [[lirroring 

* Heterogeneous networking 

• AutinnaHc disusttir recovery 

• Multj-lJircaded design 

■ Bffijt pilce/performance 
available: from S44fi- S3 743 


RESULTS 

A solid, economical, 
easily deployable 
product that fits 
your needs, 

■ Poriiilile 

* Scalable 

* Exceptional Perfomuince 

* Flexible 

* Busy Server distribution 

* Convenient tJKM terms 

F/VIRCCIIVI^ 

Server 


MAC 

Hetenogeneous 
TCP/IP Network 


Yqu oanL find a better client SDK uwith these festurei;^ 
Over sixteen years of proven reHability and performance. 
No one else suppoi-ts over 30 platforms in this price range* 


c-tree Plus® 

■ Complete C Source 

• Single/Multi User 

• ClECni/ServEr (ciplional) 

• Full ISAM functionality 

• No Knyulliiis 

- 1'ransaclion lYocessing 

• Fixed/Vanable Length Records 

• High Speed Data/1 iidex 
Caching 

■ Batch Operations 

■ File Mirroring 

■ Multiple Contexts 

• Unsurpassed Portability 


FairCom® Server 

■ ClkrilAScrver Mtnhd 

■ Transaction Processing 

■ Requires c2MB lUVM 

* Online Backup 

* Disaster Recovery 

* Rollback Forwnrd 

* Anti-Deadlock 
Uesolulinii 

* Client-side "C" Soiiicc 

* Multi threaiiing 

* Heterogeneous networking 

* File Mint!ring 

* OEM/Source Available 


FDR YDUR (NEXT PROJECT CALL FAIRCOM: YOU 
CANT FIND A BETTER HETEROGENEOUS 
CLIENT/SERVER SOLUTION! 


Also inquire about these FatrCom prodtiels: 

d-tree’“ 
r-tree® 
ODBC Driver 


FAIRCOIVr 


COI=t RO R AXIO INI 
Since 1979 

^WWWeb Address: hap://wiMN,faiR3m.cxnv' 

aaa-a34-aT aa 

U.S.A. phone (573) 445-6833 (ax (S73) 445-9698 
EUROPE phone (035) 773-464 fax (03S) 773-806 
JAPAN phone (0592) 29-7504 fax (0592) 24-9723 


• HPSOOa • RS/6000 • BUN O/S 4.X • 


public void add3hape( Shape nevShape ) 
f 

shapes .addElenient( newShape ); 

) 

public void pa1nt( Graphics g J 

1 

for ( BtiumcraLiofi e = shapes,elementsO ; 

e,hasMorelieraents{): ) 

f 

Shape s - (Shape)e,nextEleiuent (): 

E,draw{ g ): 

1 

1 

public Shape findInShapeList( int x, int y ) 

[ 

for ( Enumeration e = shapes,elementflC); 

e,hasMoreElaments[): ) 

i 

Shape s = (Shape)e.nextElcmcnL(); 

if [ s.isFointlnShape( x. y ) ) 

1 

s,setHighlight( I s.isHighlighted{3 ); 
E,draw[ getGraphics0 ); 

return r.: 

I 

I 

return nulit 

) 

public void update (Graphics g) 

I 

paint(g): 

1 

public boolean iiiouseDovn( Event e* int x, Int y ) 
curShape = findTbShapoLisL( x, y ): 
return true; 

1 


public class ShapeWorld extends java,applet,Applet 

1 

ShapeCanvassCanvast 

final int shapeWidth = 20; 

final int shapeHeight = 20: 

public void initO 
1 

int X, y: 

fiCanvas ~ new ShapeCanvasC 440* 290 ); 
addC sCanvas ): 

Random fan new RandomO; 

Rectangle h = sCanvas.bounds(): 

for ( Int i"l; i<”IO; i++ ) 

[ 

X = b.x + (int)((float)(b.width) * ran.nextFloatO ): 
if ( X > b,x + b.width - shapeWidth ) 

X EhapeWldth: 

y = b,y t (int)((float)fb.height] * ran.nexlFloat() ); 
if £ y > b,y + b.heigh I ahapdieight ) 
y shapelieight: 

RectShape r ^ new RectShapef sCanvas, x, y, 
shapeWidth* shapeHeight ); 
sCanvas.addShape( r ): 

[ 

I 

1 
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Save your typing, then creaie a new source code file named 
ShapeWorld.hrml and add ino the projea, Here's the htmJ: 

<title>ShapeWorld</title) 

<hr> 

(applet ci>debase''"ShapeWorld Classes'* code*'**ShapeWorId.class" 
¥idth=500 height-300> 

(/applet) 

(Hr> 

(a href-^SbapeWorld.java">Tlie source.</a> 

Running the ShapeWorio Appiet 
Once your source and hunl are entered and saved, ain the 
ShapeWorld applet. Figure 1 shows my Shape World applet 
running in the Mctrowerks Java applet runner. The ten shapes all 
appt'ar in red on a Canvas with a background color of yellow. 
The sha[3es are randomly distributed thiougbout the Canvas. 



Figure L the ShapeWorld applet with no shapes selected. 


Figure 2 shows what happens when I dick the mouse 
inside a shape. In this case, I've selected six of the ten shapes. A 
two pixel lx)rder is used to mark a shape as selected. 



The ShapeWorld Source 

ShapeWorld creates four classes. ShapeWorld is the main 
entry point and extends the java.applet.Applet class. The 


ShapjeCanvas class implemencs the Canvas. The Shape class is an 
abstract class which means tliat 1 won't be creating any Shape 
objects. The RectShape class extends the Shape class and is used 
to aeate the ten .sliapes you see in the ShapeWorld Canvas. 

As you look through the Shape class, remember ttiat all the 
variables and functions will be inherited by any classes that 
extend Shape, highlighted is set to tme if the sliape is selected, 
false otherwise. shapeCanvas is the enclosing Canvas. shapeX, 
shapeY, shapeWidth, and shapeHeight define the boundries of this 
Shape. boundsBect does the exact same thing, bur stores this 
same info in a Rectangle instead of in individual variables. Why 
the duplication? With both foniis available, 1 don't have to spend 
time converting from one form to the other. Tlii.s might seem like 
a frivolous waste of memory, but when we are stepping through 
a latge number of shapes, fx:rhaps during a redraw cycle, die 
little time we save can make a difference. 

import java.awt.*; 
import javfl.Utii.*: 

abstract class Shape 
t 

boolean highlighted; 

ShapeCanvasshapeCanvas; 

int shapeX, shapeY. stiapeWidth. shapeiieiglit: 

R f!C ta cgl a boun d sRec t: 

The Sliape constructor initializes the Shape varialiles. The 
draw() function is declared abstract, which means it must be 
overridden by any class that extends Shape. Note that an abstraa 
function doesn't have a function body. setHighlight() sets 
highliglited to a new value. isHighlightedO returns the value of 
highlighted. Finally, isPointlnShape() takes advantage of the 
Rectangle classes' insideO function lo tell you if the specified 
point Ls inside die Shape's !K)undmg Rectangle. 

Shap^C ShapeCanvas canv, int j;, int y, 
int width, int height ) 

i 

shapeCanvas “ canv; 
highlighted false; 

shapeX “ x: 
shape¥ “ y; 
shapeWidth = width: 
shapeHeight = height: 

houndfiRetJt " new Rectangiet y. width, height ): 

I 

abstract public void draw{ Graphics g ): 

public void setRighlight( boolean newHighlight ) 
highlighted = newHighlight: 


public boolean isHighlightedO 
return highlighted; 


public boolean isPointInShapet int x, Int y ) 
return boundsRect.insideE x. y 1: 
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ItectShape extends the Shape class. The RectShape 
constructor just passes on Its parameters to its superclass 
constructor, which is the Shape constructor. If the shape is 
selected, the draw() funaion draws a l^lack rectangle. inseLs ilic 
rectangle by two pixels f>n each side, then draws a red rectangle. 
I could have used two calls to drawRect() to frame ihe black 
rectangle folk wed by a call to fillRect() to fill in the red, but ihLs 
made the ctxle easier to read. 

class RectShapp. e*xtcrvds Shape 

Rect.Shflpo( ShapeCanvas canv. int x, lat y, 

^ int vidth, ini height ) 

super( canv, x, y. width, height ); 


public vaiA draw( Graphics g ) 
tf { IstlighlightedO ) 

g.setColort Color.black Jj 

g.fillRectf ahapeX, shapeY, shapeWidth, shapelieight ): 
gvSetColpft Col(>t*reci h 
g*flllRecL( shapeX+2, EhapeYf2, 

shapeVidth-'i, iihapQHeight-4 ); 

else 

I 

g*setColarC Color.red 

g.flUReett shapeX, shapeY, shapeWidth. ahapeUeight ): 


Tlie ShapeCanvas elass is my main drawing urea. The .shapes 
variulile is <d‘ llie j:tv;LutilVector class. A Vector implements a 
gr{)w^able amiy of objetis. 1 am acces,s the objeas via random 
accew (using an integer index) or by stepping llmmgh the list. 
Since I want to lie a list of sliafKvs to my Canvas, a Vector is a 
natural structure in which to store references to the Shapes. 
Spend some time reading the java.uiihVeclor do<- to truly 
appreciate tlie value of the Vetior In addition, you should read 
alxmt the Enumeration interface (on tlie java.util page) lliat Lite 
Valor class impleinenls. llie hnumercition interface allows you 
to step ihrough your Vector using the functions 
hasMoreElementsO and nextElement(). 

clasE ShappCunvas extends C^vas 

I 

Vfjclur shapes: 

Shape curShapis: 

llie ShapeCanvasO t'tmsrructor creates a new Vextor and sets 
curShape to null. 1 mm\ niiike use of curShape tliis nKinth. hut 1 
will ase it next month to keep Inick of the last seleded Shafx:. 
Tlie constructor also st^is the background color and changes tlie 
Canvas' size. 

Sb£iptrCanvas( int width, int height ) 

shapes new Vo^;tor{); 

GurShape ^ null; 

EGrBackground{ Color,yellow ): 

rosize( width, height ): 


addShapeO adds a .shape to the Vector. paint(} .steps through 
the shapes Vector, retrieving the current Shape and calling its 
draw() method. This method of stepping through a Vector is 
extremely useful. Note that nextElement() returns an Object, so I 
needed to cast the returned value to Shape, By retrieving a Shape 
instead of a specific derived class such as RectShapeO, I can ase 
this code to draw' any Shapes stored in the list, no matter the 
type, as long as each shape is derived from Shape. 

public void addShape( Sh&pn iicwSbape ) 

shapes , add El ontcru ( newShape ): 

public void paiutC Graphics g ) 

for t Enumeration e - shapes.elements(); 

e. hssJ!otoEle»eiits (): ) 

t 

Shspe s “ {Shape)e^tiextElement C): 
fi, drawl g ); 

I 

) 

findInShapeListO also steps througfi the shapes Vector, In 
each case, I call each Shape's isPointlnShape() function to see if 
the specified point Is in the current Shape. If the [X)ini wm in the 
Shape, I Hip highliglited and redraw the Shape (since it is now 
selected.) 

public Shape findlnShapeList( int k. Int y ) 

for ( Enumeration e = shapoa,elements{}[ 
e,haEHo reRlement s(}: ) 

t 

Shape s = (Shapo)i;.nejttElement() i 

if ( s.laPointlnShapet x, y ) J 

s.setHighlight( ! KaiihiglilightedO 
s.dravC getGraphicst) ); 

return g; 

I 

I 

return null: 

I 

The updateO function calls paint(}. The default update() 
(inherited from the Component cla,ss) erases the area to be 
updated and then calls paint(). By ailling paint() without the erase, 

1 avoid an annoying flicker. This trick Ls well warlli remembering. 
To truly understand what it does, comment out tlie entire update() 
method (not just the call to paint() which wall prevent drawing 
from cxcuring at all!!!) 

public void update (Graphics g) 

I 

paint(g); 

I 

Tlie mouseDownO funcuon gets called when I click the 
mouse in the Canvas, At the mumeni, 1 don’t do anything 
interesting witli die Shape returned by findlnShapeLisl(), but 1 will 
next month. 
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Mac, go out and touch the world 

A pjVjM ADS I/O Ids your customers' Macs control things, il Ids Itiem ^ 

I ^ physical world. 

Thoutandy ol Ums 

Sdeixre, MUllmodia, Children's Museums, Home Automatoi, 

Iheatre Stages, Industrial Testing, Medea! Kesearch, Bonsai 
Watering, Robotics, We^ttier Stations anything that can 
tie dednonlcally measured or oor^t^dled can us*:: the ADB I/O 

No Serial Porb OesupiMi 

ADB 1/0 uses the Apple Desktop Bus to conuTiunicate inputs and 
outputs to and from your Macintosh. (Maximum polling frequency 
Is 90 H/.) No external power supply Is needed 

Eight I/O OiatirMl* rWidMi 

Rjuf rdays for output hour channels for Digital In, 

Digital Oul or 8-bit Anakag In 

Extwtrive SdtMnm Support 

With ADB I/O and nearly any envinonment,* 
it Is easy to Ixiild oistomized 
applicalions for your control and 
data acquisiikxi needs. 

For nnore info, visit ijs at 
www.bzzzzzz.comp 


public boolean tnouseDownt Event e, int x, Int y ) 

I 

curShape ” fintHnShapeTlRtC x. y ): 

return true: 

I 

1 

The last thing I want to point out tliLs montli is the use of the 
Random class. ShapeWorld creates 10 new RectShapes 
(remember, you canT actually create a Shape since you can't 
create an instance of an abstract class) using the random values 
returned by Random(). Random is described on the page 
java.util.Random. Be sure to check out that page of 
documenuiiion, as it depscribes a variety of random number 
di.stril>utiorLS and returned types. 

public class ShaueWorld extends java.applet,Applet 
I 

ShapoCfl fives sCaiivas L 

firml iJit shapeWldth =' 20: 

final Int shapcHeiEht “ 20: 

public void ittitO 

I 

int X. y: 

bCanvas = new ShapeCanvasl ^40, 290 }: 
add( sCanvas }i 


Random tan * new KandotiiOT 
Rectangle b = sCanvas.boundaO : 

for t int 1=1* K”I0: il+ ) 

I 

X- b.x + tint) ({CloatXb. width) * ran.nextFloatt) ): 
if ( X > b.x + b.width ahapeWidth ) 

X fihapeWidtb: 

y = b.y + (Int)C(float)(b.height] * ran.nextFloat() ): 
if C y > h.y + b.height ’ shapeHeight 1 
y '= shapeHeight; 

RactShape r = new ReelShape( nCanvas, x. y. 

shapeWldth, shapeHeight ); 
aCanvas.addShapa( r ): 
i 

) 

I 


Till Next MoivrH.,, 

As promised, next month 111 add some new functionality to 
ShapeWorld, Before you peek at next month's column, try your 
hand at adding a new Shape subclass to ShapeWorld. 
HxperimenL. Read the doc. Ill see you then,.* B 
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GAME 

DEVELOPMENT 


My Jeremy Vineyard, Viperu’are 



Sprockets are Forever 


Macs Were Made 
to Play Games 


The BECJNNrivr.... 

Wlicn 1 was a child, I used Lo beg my 
parents for quarters to play in the local 
arcade. Wasting thoiisancis of hours with this 
activity, 1 deveiojxti a piLssion For creating 
games. 'Hie desire to create rny own giimes 
magnified with every quarter 1 spent. 

Reality is often harsh, especially for 
the would-be game developer. I 
discovered tliat games can Ixf very difficult 
to write. .4 good game developer must 
have extensive knowledge of animation 
lechnitflies, music composiLit>n, .sound 
recording, graphics synchronization, 
algorithm design, data structures, and 
more. Game developers lose sleep over 
the slowdown caused by CD-quality sound 
and lulhscrcen st:rolling graphics, and the 
complexities of an arcade game type 
environment. Until fairly recently, there 
wasn't much <!ocumentation explaining 
how to write games, if you wanted to 
learn, you did so by trial and error. 

Noi long ago, Apple ofricially 
announced something that Mac lovers have 
knf>wn for years: the Mac is a game 
rnacliine. In fact, the Mac is a great game 
rtwchine, featuring built-in support for higli- 
resolution graphics and CD-quality .sound. 
Along with this announcemenL, Apple 
resolved lo help Mac game developers 
write even cooler games for the Mac. Tlie 
result — Apple's Game Sprtx:kers. 


What is a Sfhck^kft? 

A sprocket is a component of Apple’s new game 
development architecture. Rach sprocket adds extra features to 
llie MacG)S that specifically Ixmefit thcxsi^ who are writing games. 
There are .six spnrx^kets currently under devekipment by Apple: 
DrawSprocket, SoundSprocker, InputSprocket, NetSprockel, 
SpeechSprocket, and QuickDraw 3D Rave. SpecchSprocket is just 
a repai'kaged version of Apple’s Speed i Recognition Manager. 
Game Sprockets will rim only on PowerMacs, !>ut certain 
sprockets may lx jxjried to 68k in the future. Game SpnxkeLs 
ragiine die newest system softw^ire including Open'lraasport LI, 
Display Manager 2.0, and Sound Manager 3-2.1. 

DkawSprckiket 

Prepare for battle! Flames mplure your view; sirens wail. 
You have die enemy in your sights. PiRf! The screen jerk-s and 
the action grinds lo a hall. Unexpectedly, you find yourself 
waiting for die screen to refresh. As the computer ailculales the 
next frame of animation, your senses are brought to terms wltli 
reality. You lose interest, quit, and go to your living rtx>rii to 
read a book. Full-screen, Idgh-re.soliuion graphics are quite 
[xis.sibly the bane of all computer games. 

Tlic Macs make gre^it game machines, hut diey lack certain 
characteristics that make the primeval PCs more suitable for 
[ilaying games. One noticeable shortcoming is rhiJt unlike PC’s, 
most Macs don*t have page-flipping. Page-ni]iping is the ability 
to almost instantly switch frames of imimation by simply telling 
the display device (the moniusr) to look somewhere else in 
memory for the display data (the graphics), DrawSprocket 
provides transfiarcnl support for page-flipping on the Macs tfial 
support it, and falls back on more cximpatihle methods for those 
that don't. When page-flipping is not available, DrawSprocket 
reverts to using CnpyRits, which is much slower than page- 
flipping because QuickDraw must copy the entire contents of 
each frame of animation onto die screen. 

Draw'Sprocket also supports multi-buffering, with which the 
next frame of animation can be drawn even while the current 


Jeremy Vineyartl is a senior .software engineer at Vifxjiwaie, a Mac game company. HLs imprests include developing games, 
.software utilities, and application class libraries. He can he readied at <jeremyv@vi[x‘rware,ct>m>* 
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frame i.s being copied to the iicreeri. Multi-buffering can 
dccrea.sc the animation bottleneck that occurs when the 
processor overtakes the sjx^cd of the display device. 


r-Please Select a Display: 



Cancel j 


that are common to g^ime-related input devices. Gaines lliat usc^ 
InputSprocket can interact directly with these elements, 
eiiminaiing tlie need for the elements to be emulared through 
the mouse or kcylxjard. 

You can create your own interface for chcxjsing tlie active 
game device and assigning functions to game controls, hut 
InpulSprtxkel provides a standard user inierface for you. 
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Figure /. Select a Display untb DrawSproeb^t, 


Figure 2, InputSpnKkei Interface. 


DrawSprocket offers conanon game-related tasks such as a 
user interface for selecting monitors and providing an easy w'ay 
for games to take control of the entire screen, which includes 
hiding the menu (>ar and blanking all unused monitors. 
r)rawSprf)ckei take.s care of hiding the screen to any color by 
altering a monitor's gamma tables. This is good for making a 
cool fade, setting up tlie .screen for the next sc-ene, and fading 
back into the game, 

DrawSprtxket imkes it c'asy for you to include an underby 
in your g^ime. An underlay is an image thai is always behind ail 
other graphical elements. For example, you might have a 
STTolling picture of a mountain thit is always in the background. 
In the future, DmwSpnxket will support overlays allowing game 
developeis to cosily implement fcjnjgit>und images. 

Drawsprocket's routines can provide your game with a 
ctinsistciit Frame rale so that the animations don't change 
speed when Lhc7 ore becoming mcjre or less processcir- 
intensive. J-or the animated elements, Apple i>rovides a sprite 
manager within QuickTime. 

InpitSprocket 

Have you Ixen Frustfated while trying to use a Mac joystick? 
Until ihe intiodiKiion (>f fnputSprcxket^ the Mac had no built-in 
support for game input devices, resulting in emulaied 
performance by the Mac joysticks, flight .sticks, and game pads, 

InpulSpnxkel Is an API for the Mac joystick developers 
that provides a consistent user experience when using joysticks 
and other game-related input devices on the Mac, Joystick 
manufaciurers write drivers for their devices that communicate 
with games aixml the elements of the pyslick. Some examples 
of elements are buttons, controllers, directional pads, and others 


For a game input device to w'ork with InputSprocket, a 
driver must be written for tliat device. As of tlie writing of lliis 
anicle, no joystick manulacturers shipped InputSprocket drivers 
for theif products, but companies such as Gravis and 
Thrustmaster have demonstraled prototype InputSprocket 
drivers. InputSprocket has probletns working with some third- 
party input devices such as Kensington mice, but Apple 
dcvciopeis are working to fix this problem. 

QuiciiDRAW 3D RAVE 

QuickDraw 3D RAVF (Rendering Accelerarion Vimial 
Engine) is a Hardw-are Absuaction Layer (HAL) tlial allow,s 
game developers w^ho write their own 3D rendering 
engines (as does Rungie for Marathon) to take advantage 
of the features offered by 3D accelerator cards when they 
are present, QuickDraw 3D Rave is a stripped-down 
version of QuickDraw^ 3D, and It is highly optimized, 
tnaking it ideal for game developers who need every 
amount of speed they can get. 

Games communicate with QuickDraw 3L> RAVE by 
converting thetr rendered images mio triangles, which RAVE 
then sends to the accelerator card if present, or otherwise 
emulates in software. In addition to supporting 3D accelerator 
cards, RAVE will .soon be cross-platform, allowing game 
developers to easily pt^rt tlieir lowlcvcl 3D rendering ctxle, 

Soli]ndSpr<m:ket 

3D games arc die mge nowadays. This is evidem by the 
huge sales of games like Doom and Marathon. Along with 
freedom of movement comes the responsibility to make the 
user experience as realistic: as possible. Players are expecting to 
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he drawn inlo Ificir gamc.s more and more as computer 
f^jrcxrcssing power increases. 3D sound adds an extra dimension 
of reality and helps the game developer write really cool games. 


—Speaker Setup; 

# Stereo Speakers 
O Mono Speaker 
O Headphones 


—Speaker Ragle: 


[ taacel ] |[ OK ]| 


Figure Configuring a Sound Device for 3D Sound. 

SouncLSprocket adds the capahiliiy of making sounds 
appear to come from posiLit>ns relative to tlic game }>layer. Tlus 
allows realistic feedback such as: ""The aliens are to my left!'* 
and can make game play much more enjoyable. Like all the 
other sprockets^ SoundSprocket provides a standard user 
interface lor configuring sound output devices to take maximum 
advantage of their 3D sound capabilities. 

Future versions of SoundSprocket promise t{) add effects 
sLK'h as altering sound as it travels through the environiiiem. 
Sound will be heard differently based on the humidity of the 
environment, and will even !x" at>le to travel through dense fog 
or water. Sound will also revcrlxTate by Ixnincing off walls. 

You don't have to have a 3D game to benefit from 3D 
sound. Most games that use sound effects can benefit from 
more realistic sound and a more in-deplh user experience. 

NetSprocxet 

As adrenaline pulses ihrough your veins, y(jur finger slips 
from sweat as ytju pull at the trigger. Tlie force frcjm die rcxrket 
blast kicks you back. Splat! A direct hit. You drex)! in ecstasy as 
your opponent's corpse .splatters to the ground. Are you 
t:ompeling in li](K>dsport? No- you have just finished off tile fast 
of your assailants in a networked game of Marathon. Unlike 
competing against a personality-less computer, going head-to- 
head with your best friends (or even your enemies) ean be a 
licx.'k of a g(X)d thiic. 

Macs have been one of the easiest platforms to network 
together since their introduaion. Setting up a ItKal area netwtsrk is 
as simple as c:onneciing a cable Ixtween two Macs. This ease of 
use takes most of the pain out of adding networking to Mac 
games. However, because tliere are many different protocols that a 
network might support (IP, IPX, AppleTalk, Serial, etc.), a game 
developer probably won't have time to implement all of these 
protocols in addition to testing tlie reliability of their network code, 


NetSprocket provides a set of liigh-level routines designed 
specifically to help developers add networking code to their 
games. NetSproeket liidcs the low-level details of the network 
from the programmer and takes care of many tasks that the 
developer would otherwise be forced to implement. 


Sefect the protocoKsI for aduertising 
^ HppleTall! 

E TCP/IP 


Port: 


2000 



[ Cantel j | OK j) 


Figure 4 Hosting a Neiumrk Came. 



NetSproeket Ls based on a client/server ardiiteciure in tliat 
one player acting as a server liosts a game session, and other 
players join as clients to the network game. In the future, 
NetSproeket will provide more models other than the 
client/server model for interaciing Ix^tw'ccn networked players, 
NetSproeket hides the implementation details of supporting 
various protocols, saving the developer time needed to re-write 
the networking ccxle for each proltxol. NetSproeket is fast and 
fault toierant — when one computer in ilie networked game 
crashes, it doesn’t bring down everyone else. Since the low- 
level network code is already written, NetSproeket can save a 
game developer hundreds of hours of work. 

NetSproeket assigns each player a player ID and a player type. 
Player types might include referees, observers, and partidfjanis. 
Players can belong to groups {red Lc-am, black team, etc). 
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A networked game works like a conversation — players 
pass messages back and forth* Ihis communication activity is 
known as a proUictil A network protocol is very miK'h like a 
coQvcTsation — players ask questions and wait for responses. 
Although NetSprocket makes it very easy to pass messages 
between netw^orketl players, knowledge of designing protcK'ols 
is importanL. FonumiLely, designing proi(Kx>ls is not a difficull 
topic to learn, and can end up being somewhat addiding* (Or 
maylx' it’s just me?) 


To Infinity and Beyond 

Apple is not supporting 68k machines with its Game 
Sprockets architecture* Lfntil Apple develops 68k versions of 
Game Sprockets, Game Spnjckct developers must limit ilicir 
audience to PowerMac users* 

Apple has a tarnished reputation for settling for 
complacency when it releases new' technologies to developers 
(see QuickDraw GX, AOCE)* In order for Game Sprockets to 
thrive, Apple must provide game developers with an abundant'e 
of tools, source code, and updates to the existing API. 
Thankfully, Apple has been doing a good job with Game 
Sprockets, keeping updates coming steadily and keeping in 
touch with the developers who use the technologies* 

Apple's Game SprockcLs are dehnitely a step in the right 
direction if tliey want to remain a cO[ii]xaitive OS solution into 
the future. 1 look forward to seeing games released that take 
advantage of the feature.s that are offered. Thank you to those 
fx:oplc wiiliin Ai>j>lc wlu> arc working liard to bring more ccxjI 
games to the Mac! 


Footnote 

The Iiitenict is a great place to find inlbnnation on A[)plc's 
Game Sprocket architecture. Here are some URL's that am help 
you get started* 

Ai)t}le's Game SprcKkct Page 

<http://devjnfo*apple.com/evangelism/games/games.htinl> 

Devela[5cr University Course^ Game Development witli 
Sprockets 

<http://devworld.apple*com/dev/du/Us[ng_GamOprockets/Using_Sprocket 

s*html> 

Ucorice Web l^age for Game Sprocket Developers 

<http://www.viperware.com/licorice> B 


Visit MacTech Magazine’s Web site! 

http://www.mactech.com 





lObjectSetl 


Mail 

enabling 
made easy 

Its nem beeri iliis la add custum me^^ging to 
your nppficDrtQns. Send ond receive moil. HflfidJe 
allochmenls, Jusi use ObjetlSel 


Idcol fur Intnmct/lnimnet cfivirnnnionts,, OtrjcctSet 
gives Mocintosh, Be ond Wiodoirvs devebpers reliable 
APIs for MIME, SMTP and POP3 protocols ObjedSefs 
royolty-fTee saflwore componeitts ore perfect for 
developing opplicalions fihkh reqaire integrated 
messoging service^ 1mm commercial software 
putkoges to imlm lorporole applicolions* Wfth 
ObjoU^l, you benefit from moil pratorob witbiit 
hoving to leam, code and debug them on your own. 


Come roko q rloser look at our librorios, 
documeniQiion and demo opplicolians. Tliey re on our 
Web jiisl br you [httpy/www.smartffidcsaft.com). 
Download o free copy todoy ond see why ObjectSet 
''' APIs ore the easiest you’ll ever use* 


MIME, SMTP ond POP 3 APIs for ModntDih, Bo and Windows 
C+ + doss libmries 

Framework infegralion using PowerPlont, MocApp, MFC 

Documentation, samples and reusable code 

MIME encoding/decodf ng: Base 64 , Qifoted-Prlntable, UUDECODE, 

Bin Hex, AppteSmgle, AppleDouble 

Send messages using SMTP, retrteve messages using POP 3 

Supports OpenTfonsport, MocTCP, BSD Soebts, Win Sock DLL 

Subscription price includes next two upgrades free 

Portable multiplolform version and source code also ovoilable 


SAAARTCODE 

a r I w A X t 

SmnEtcodeSoJtwoTe, be 
Ptionfl:(S47)945-35U 
Fek(B47) 945 6889 
htlp Arww.urarrfodesoft rom 
mla]les(o)vrw rltadesofl xm 

111 Euiupe 

Phonci 4*33467 593040 
Fax; 1 334 67 59 3048 
fi1lp//www.yTiurk{ide.lr 
mtsoles@smflrtcode.lr 
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PROGRAMMER'S 

CHALLENGE 


By Boh Boonstra, Westford, MA 



This monlh's Challenge is going to be another round-robin 
competition for a well-known lx>ard game — this time the game 
of Othello. The classic game of Othello is played on an 8x8 board 
using discs that arc black on one side and white on die other 
side. The game starts with four discs in the center squares of the 
board, two black discs on diagonally adjacent squares, and two 
while discs on the other diagonally adjacent squares. Players 
alternate placing an additional disc, witli black moving first. A 
move consists of “outflanking" one or more of your opponent's 
discs. Outflanking meaas placing a disc so that at least one row 
of your opponent’s discs is bordered by a disc of ytsur ctilor, 
including the disc just placed on the tx)ard, A row is defined as 
one or more discs of a single color in a continuous straight 
horizontal, vertical, or diagonal line. When a player moves, the 
row or rows of outflanked discs arc flipped over showing his or 
her color. If a player cannof outflank a disc, the turn is forfeited 
and the opponent rakes another turn, ITte game is over when the 
i-^oard is filed or neither player cm move. The player with the 
most discs showing is die winner. 

[n this Challenge, the game will be generalized to lx>ard 5 
larger than 8x8. The prototype for the code you should write is: 


Boolean /UegalMove*/ Othello ( 


long boardSize, 
long oppRow. 
long oppCol, 
long 'moveRow, 
long *FnnveCol. 
void *privSto£age * 
long stocageSize* 
Boolean newGaTse. 
Boolean playBlack 


f* number of rows/colunms in Ihe game bi>ard *1 
!* mw where opponent la^si moved. 0boardSize-1 */ 
column where opponent \?ls\ moved, 0 .. hoardSize-l •/ 
return your move - row, 0 „ boardSixe-1 *1 
f* return your move * column, (IboardSi7e‘l V 
f* pncaliocatcd sloragc for your use */ 

/* size of privStorage in bytes */ 

f* TRUE if this is your first move in u new game 

/* TRUE if you play first (black pieces) 


For your firsi move, Othello will be called witli newGame set 
to TRUE. Ihe size of the board, an even number between 8 and 
64, will be provided in boardSize. On your first move you should 
initialize the board with white tiles at (row,col) = (boardSlze/2- 
bboardSize/2-1) and (boardSi2e/2.boardSi2e/2), and black tiles at 
(boardSize/2'1,boardSize/2) and (boardSize/2.boafdSize/2-1). Rows 
and columns are numbered from 0 to boardSize-1, If playBIack is 
TRUE, you arc to play tlic black pieces, and tlicrefore play first. 
Otherwise, you play the white pieces. Your code and tlie code of 
an opponent will alternate play. Your opponenfs move will be 
provided in (oppRow, oppCol), which will l)c set to (-1,-1) if your 
opponent is unable to move or if you are moving first. Wlien your 
code is called you should flip your tiles that were outflanked by 
your opponent’s move, calailate your own move, and store it in 
{*moveRow. *moveCol). If you are unable to move, store the values 
(-1,-1). If for any reason you believe your opponent has made an 
illegal move, Othello should return a value of FALSE, otherwise it 
should return TRUE. 

Your code will be provided with storageSize bytes of 
preallocated stomge (at least 1 MB) pointed to by privStorage. 
This .storage will be pre-initialized to zero before your first move 
and will persist between moves. You should not allocate any 
additional dynamic storage beyond that provided by privStorage. 
Small amounts of static storage are permitted. 

The Challenge will be scored by a tournament where each 
entry plays against each other entry twice for each of a number 
of board sizes, once playing the black pieces and once playing 
the white pieces. In the event that a large number of entries are 
received, another fair tournament schedule may [)c used. The 
score will be based on the margin of victory (or loss) and the 


THE RULES 


Herts's how it works: each month wc present a new programming 
challenge Firu, wrife some code that .solves the challenge. Second, optimize 
your code (a lot). Tlien, submit your solution to MacTech Magazine. We choose 
a winner based on code correctness, .speed, size, and elegance (in that order of 
imponance) as well as the submission date. In the event of multiple equally 
de.sirable .Sjtsiuiions, we ll cibtKise' one winner (with hontinable mention, but no 
prize, given to the runner up). The prize for each month’s best .solution is a $KX) 
credit for Developer Depot™ and a limited-edition The Winner! MacTcch 
Programmers Challenge" T-shirt Cnof available in stores anywhere), 

Unless stated otherwise in the problem statement, the following rules 
apply: All solutions must be in ANSI compatible C or C++, or in Pascal. We 
disqualify entries with any assembly In them (excqpt for challenges specifically 
stating olhervvise ) You may call any Macintosh Toolbox routine (e.g,, it doesn't 
matter if you u,se NcwPtr instead of malloc). ’Wc compile all Entries into native 
PowerPC code with compiler options .set to cnabic all available speed 
optimizations The development environment to be used for selecting the winner 
will be stated in the problem, limit your code to 60 diaraciers per line or 


compress and bin hex the .solution; this helps with c-mail gateways and page 
layout. 

We publish the solution and winners for each month's Programmer's 
Giallenge tliree months later. All submissions must be received by tl>e 1st day of 
the month printed on the front cover of this issue. 

You can get a head start on the Challenge by reading the Prograniiuer's 
Challenge mailing iLst. It will be posted to the list on or before the 12th of the 
preceding month. To join, send an email to listserve@listmail.xplain.com with 
the message “subscribe challenge-A^ 

Mark solutions ‘'Attn: Programmer's Challenge Solution" and send it by e- 
mail to one of the Programmer’s Challenge addresses in the ''How to 
Communicate With Us" section on page 2 of tills issue. Include llie solution, all 
related files, and your contact info. 

MaCTcch Magazine reseTve,s the right to publish any stjlution entered in the 
Programmer’s Challenge. Authors grant MacTech Magazine the excltisive right to 
publish entries without limitation upon submission of each entry. Authors retain 
copyrights for the code. 
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Announcmg 

MICROEUARD^ 


Why so many developers are switching to 
MicfoGuard copy protection 


• MicroGuard is committed to uncompromising 
technological superiority 


• MicroGuard has now surpassed its own 

technological lead, actually improving on the best 



at its peak"* is our dommiifneni m you. That Is why wc have 
bmughl you MicroGuard PIils™ And, MicroGuard Plus is 100% 
backwards rompatibic with MictoCuaitl. Tltis means MiooCuard 
and MiooGuarxl Plus can be used inierchangeablv'. 

Just as we promised! 


• MicroGuard offers you the 
most sophisticated network 
protection 

Our network protection, MicroGuard Net^, 
is so superior^ we had to hire an Apple network 
engineer ui acmn our specifoitons. 


• MicroGuard is the only key 
developed by Mac 
developers, and is the first 
and only 100% ADB savvy key 


MicroGuard Plus is everything MicroGuard is, plus 4ft'bit encryption, two 
additional passwords, 64-Bit Array, 32-bytc public area, 45% sijte neduaion, 
enhanced muntcrand more. In atldiiiofi, MiooGuard Plus offers two new 
utilities: QiikkGuard '“ and F^syGuatid™ albw you to praiecf your 

applications without touching your 
source axle. Ibc tjnly feature that 
Is not plus is the price, 


• MicroGuard is the best 
selling Macintosh key in 
the world 

Microtiuard .sdLs more MacinttKih 
copy-proimion keys than anyone else 
in the worldt 


• MicroGuard delivers 
developer support 
within 24 hours 


We have been developing Mac applicadtxis asasmi development house 
since l9fM. We a/c nui a PC protection company that has come tt) you 
with a Mac product, MicroGuard is felty' ADR sav^y arx! offers tixtcrttled 
addressing. Unlike other protection devices, MicroGuard never cla.shes 
with other keys. Only MirroGuaRl ofFers this level of sophtsiiaiion. 


We will answer any inquiry you have within 244iours. We also have a felly loaded 
AppleLink bulletin hoard which contains all our libraries, tech rtores, Q&A and 
neady cveryiliing you'll ever need! 



For more inform^ition and io order a Deueioper^s Kit or to receive a free CD ROM about MicroCuard 
please contact us at: i 

MicroGuard USA: Tel: (305) 320-1628 • Fax: (303) 320*1599 • Applet.ink: M.GUARD c 

International: Tel: (972) 3 558*2345 • Fax: (972) 3 558-2344 • AppleLink: MICROGUARD MZCX)0 








exeaition time used to compute the moves. For atch giime, the 
sct>rc will tx: tiompuieti by 

K# of player's piccc\s showing - of oppooertt's pieces 
showing) - (execution time in seconds)/30] / 

(lH)ardSi7.e*boardSize) 

The player with tlie highest score for all games in the 
tournament will l>e die winner. 

Th<xse of you needing more infonmtion alxiui the rules of 
the game can clieck out your local toy store, or look at 
<http://www.daimf.aau.cilc/*tusk/pbmserv/othello/othello.rules:html>. 
Other information can be found at 
<http://www,afmory.com/“iioa/othguide.htmI>, the International 
Internet Othello Asstxialion page. 

Othello is a mgistered trademark of Tsukuda Original, lit:ense£i 
liy Anjar Cxk, ct)pyriglit 1973,1990 liy Fmssimn Toy Coqx>ration. 

I’hrfe Months Ago Winner 

Congratulations to Thomas Studer (Syracuse, N,YJ ff>r 
submitting the winning entry to the Router Rules Challenge. The 
problem was to generaie a set of (mask, value ^ a How-/deny) 
triplets that anild lx* used by a router to allow net access to a 
specified .sei of suhnt^f atldre.sses. Given a subnet address, the 
rules would Ix^ scanned in setpienaf by the router, and the fiist 
nile to fire would determine w'ltelher access was allowed or 
denied. A rule fires when the subnet address, logically ANDecl 
with the nile mask, is equal to die rule value. Solutions were to 
minimize a score that was ihc sum of iwo quaniities, the number 
of niles generated, and the time taken io generate those rules {in 
half-seconds). 

Of the six solutions 1 rticeived, only two of them worked 
coro'ctly for my test cases. The otlier four either genenued rules 
dial prtxluced incorrect results for some input subnet values or 
had not completed exetiirion after running overniglit. Thoims' 
winning stilution a.ssigns each input value to a group determined 
by rhe nurnlxT of bits set in etich '^cliunk'" of 1, 2, or 8 bits. Ihe 
C(xle dicn uses iliis mapping to search for “buddy" input values 
that differ in only one bit position. When such a iuiddy" value Ls 
found, the values are combined, and a mask is updated to 
indicate whit 1 1 hits should be masked out in a router rule. The 
ctxle niiikes use of three large pre-biiilt BitGrpMapper tallies that 
allow Ihomas to calculate the number of hils ,sel in each chunk of 
2, 4, or 8 hii.s. For each chunk of size n, these tables reprc'scm the 
numIxT of biLs sc‘l in each input value as a ba.se n+1 numlx^i; an 
interesting and compact representation. 

The .second-piacc .solution by Alan Hart used a recursive 
technique to generate the Karnough map representing the 
allowed values. While this approiich generaicxl more mles (and 
therefore a poorer score) than the winning solution, it ordered 
die rulc*s more tjptimally, in that rules governing a larger numlxT 
of allowed subneLs (xcurred earlier. Tills was not a criierion for 
scoring this Challenge, but it would lx an important real-world 
consideration. 

More a7in|xiLl rule .sei.s than those genemted by the two c'orrect 
solutions might be possible. The very long-running solution 


mentioned above appealed to gaierate a small number of rules, lialf 
as many in some cases, at significant execution time cxjxnse. 

"nie table ixlow provides the language, code size, and data 
size for each of die six entries received. For t he two correa entries, 
it also provides the score (based on rules generated and e.xcTUtion 
time), die average numlx^r of rules sc'anned liefore an allowed 
subnet value is granted access (summed over ah test t'ases), and 
the total number of lules generated for all test ceases. 

Name Language Score Avg Rule.^ Rules Gen Code Data 


Thoimis Sluder 

C+^ 

3365 1414 .3365 

3844 

12824 

Abn I fart 

c 

4716 1193 4715 

1472 

148 

E.M. 

C++ 

• 

6308 

6672 

L. N. 

c 

t 

4024 

220 

K. S. 

c 

• 

2472 

B 

M,Y. 

C++ 

• 

3312 

299 



TOP 20 CONTESTANTS 



Here are the 'I'op 20 Contestants for the Program me r'.s 
Challenge, Tlie numlxTs Ixlow' inchxle points awarded over tlie 
24 mast recent contests, including ixanis earnt'd by this month’s 

entrants. 





Rank 


Name 


Points 

1. 


Munier, F.rnst 


195 

2. 


Gregg, Xan 


114 

5. 


lars.son, Gustav 


87 

4. 


Lengyel, Erk' 


40 

“5. 


Irwis, Peter 


32 

6. 


Ikiring, Kandy 


27 

7. 


Cooper, Greg 


27 

8. 


Anioniewicz, Andy 


24 

9. 


fieirh, Gary' 


24 

10. 


Ka.sp;irian, Kaffi 


22 

n. 


Cutts, Kevin 


21 

12. 


Nieolle, Ludtwic 


21 

13- 


Pirao, Miguel Cruz 


21 

14. 


Brown. Jorg 


20 

15. 


Gundmm. Eric 


20 

16. 


Suider, Thomas 


20 

17. 


iName deleietll 


20 

18. 


Kitrsh, Bill 


19 

19. 


Mallett, Jeir 


17 

20. 


Nevard, John 


17 


There are three ways to etirn points^ (1) scoring in the top 5 
of any Chailenge, (2) Ixing the first pt^rson to find a bug in a 
published winning solution or, (3) being the first person to 
sugge.sr a Challenge that I use. The points you am win ate: 


1st place.20 points 5ih place...points 

2nd place.—10 points finding bug...2 [xiints 


3rd place..7 points sugge.sting Challenge ...2 points 

4th place_ 4 points 
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Here is Tlioiiias’ winning solution: 


RoiniiKRiiiJ-Ls.cp 

eo?Y8iGirr © 1996 Thomas 

// Mtrmon* requirements 
/;- 

// Ahmii 12K of static tahks. A ^'ariablc amount of lieap memon. The will nm 

// faster arul/or yield compacter resujLs |;ivcn nwjre memon' (in most eases). Tiic 
// maximum amotint of dynamic memnn' Ls appmxtmaicly' (diunkhizc-i-t)^chunkO>um 
// times die sm* of a pointer + the niimbeT of input ^'jlues times 12 bytes (tbe swe of 
//BitfjrpEntry), *clumkSiw;‘ is 1, 2, 4 ox 8. ^^bunkCount' is the width fin hits) of the 
// input values / ehunkiibcci rounded up. vUunkfilount’ Is between 4 and 32, inclusive, 
// 

// How it works 
//- 

// - IHt values to be reduced are amnged in memory in a number of linked JLsts. 'Ilie 
// program then loops tluough these lists trying to (iml values (with matehing masks) 

// that differ in exactly one hit ('bwtkly' values). The value in a pair of such compatibk 
// values that has a I in the only differing hit position is thrown away and the ma-sk of 
// the the remaining value ts updated by clearing tlyt hit. If, for a given value no 
// 'biKkIy' can be fnunct it is output and the program continues until all the intemaJ 
// lists are empty. 

// 

// ’ llie values arc arranged in ‘bit group.s‘ to quickly locate a given value’s buddy. A hit 
// gnmp b identified hy a uumlKr wlmw individual digits denote the number uf hits set 
// CO I widiin a range of consecutive bits in tlie input value. A range of c^msecuttvc bits 
// b c.aJled a 'diunfc'. Chunk si/es can he 1, 2,4 or 8. for example, an input value of 16 
// bits that kmks like this (chunkSi/e 4): 1101 1001 0001 0111, will liave group value 
// 321,3 (base 5, since every digit denotes the number of 1 'S (0..4) per bit sequence 
// (chunk). During initialisation, all the input values are eategurked using that scheme 
// by storing tlicra in fists (one list for every hit group). P^Mtitcrs to the first ekmems 
// (BitGrphniry 's) of these lists arc kq^t in rhe gHiirirplists array. A particular bit group 
// can now be aeeessed using ibt lui group value as an index into that array. For any 
// given value, to locate a buddy, only those bit group lists have to be searched that 
// difTer by J in exactly one digit. 

// 

//- The class BitGrpMapper is respon.sible for the initial categoriaaUoo of dte input 
// values (thmugli one of three lookup tables, depending on chunkSize). Tlie class also 
// ealcuUles and stoits some oeht r values pertaining to the currem run's chunk size, 

// The bulk of dte base 5.5 or 9 arithmetic (namely, when for a given value the buddy 
// groups have u> be located) b done in RemovcLoopO. For the chunkSiTC ^ 1 case, 

// no lookup tabJe Is required because tlu: hit group number is a binary' number. Some 
// of the functions have been optimLsed for the I trit case. 

// 

//1 ihitik Ibc algorithm is quite nice. However, there is some room fur impntveintni in 
// itie impleutciitatiou. Moreover, the sty le of the code coidd be improved - it is not 
// particularly readable and it doesn't ntake enough use of types to make die code more 
// expresive (basically another oiu: of those C turned C++ pn^rams * I'm working on it). 

//dorino ALTRR^TKPUT VALUES 1 

^include “FrovidedGode,h” 

^include “BicGrpMapper»h“ 

// Data strucis and types 

eniim ErrCndn I kHoErr “ 0, 


Struci BitCrpEntry | 

BitGrpEntry 'next: 

ulng value; 

ulng mask: 

h 

typeder BitCrpEntry 'BitGrpEntryPtr; 


Prott>types 

KrrCodes Inlt{ void ): 

ErrC^odo Trocefis ( void ); 
long Cleanup( void )i 


void 

HukeCk^mplnnient ( 

void }: 


void 

InitaitGcpLists( 

long ; 5 tart Value, 

long pnstValue ); 

void 

ClesrHe!iiory{ 

long ‘p. 

long blockCount ): 

void 

FrocessLisist 

void }; 


long 

RemoveValues( 

void ); 


void 

RetnoveLoopC 

long 

BltGrpEnttyPtr 

BitGrpEntryPtr 

curldx, 
beforeEntry, 
curEntry ): 

void 

RemoveLooplBit( 

ulng 

BitGrpEntryPtr 

BitGrpEntryPtr 

curldx, 
heforeEntry. 
curEntry ): 

long 

ScanAndKeop( 

BitGrpEntryPtr 

BitGrpEntryPtr 

ulng 

ulng 

compareEntry. 
beforeEntry* 

ma^k, 

matchBit ); 

long 

ScanAndRemoveC 

BitGrpEntryPtr 

BitGrpEntryPtr 

ulng 

ulng 

corapurcEnt ry, 

beforeEntty. 

mask, 

matchBit ): 

inline 

long Match{ 

BitGrpEntryPtr 

BltGrpEniryPtr 

ulng 

compareEntry, 
thisEntry, 
malebBIt ); 

void 

AddToOutputf 

BitGrpEntryPtr 

curEntry ): 


Global data 


1 ong 

*gAllowedValues: 

long 

gNumAllowedValues: 

long 

gfiumBits; 

Rule 

'gCurRule; 

long 

g^axRules: 

long 

gRulesLeft; 

long 

gBiockNumAIlowedValues; 

long 

gStartMask; 

long 

gAllow; 

B1tGrpMflppor 

gBitGrpMappe r: // the UitGrpMapper dass 

BitGrpEntryPtr 

* gBitGrpLlstfl: // Array of BitGrpLntr> 


// list headers 

BitGrpEntryPtr 

gFirstPreGEniry; 

long 

gNuniBitGrpB locks; 

long 

gHumValuesInLlst s; 

// implcmcotaiion 



// For any run, depending on the numhcf of inpttt values and the amount of available 
// mefm>ry', various eombinaLk>ns of chunkSize and gBIockNnmAUowedValues are 
// pos-sibk, ykldtng differen: results and different cicaition times. There wasn't 
// enough time to sidfeciently analyze die program s algorithm. Hiat's why this fitnatan 
// contains a lot of guessing, 'The while loop in lnit() starts with a small chtmkSize (I or 
// 2) and tries to allocate the required ainount of memory. If that faUs, the number of 
// input values processed at a time is split in half, requiring Jcs,s memory for the aaual 
// values. If that still takes too much memory, the chunkSize is increased, the number 
// of values to be processed is rcset and the attempt to allocate memorv' is repeated 
// 

KrrCode InitC void ) 

I 

const long kBitr*iijilt = 27; 

const long kMeioLiiait " IL « kBitLimit: 

long valueHom: 

long splitCount = 0; 

long chunkSize ” 1; 


continued on page 22 
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gBitGrpLists NULL: 

gBlockNumAll owed Values “ gHuoiALl la wed Values; 
jf {gNunBlts > kBltLimit] cbunkSise “ 2; 

while CgBlockNuinAi loved Values > 0> I 

// init gBitGrpMapptr fur cummi chunk siic 
gBitGrpMapper.Init( chunkSi^e, gNumBlts ); 

If (aplitCount ™ 0 && chimkSize !“ 0 && 

gBltGrpHapper.nuaiGrpLists / gBiockULmAIlowedValues 
> 60) I 

// Very scarce -> Force sMt lo next chunk sisc 
spiltCount “ 100; 

I else [ 

If ( 4 * gBltGrpMappet.nuaGrpLists < kHemLimit) [ 

// How many blocks of 8 BitGrpHniryPir s? 

gNumBitGrpBiocKs “ gBitGrpMappet.nuaGrpLlsts/8 + 1; 

// How much memory for the vaJues 

valueHem 

gBlockNuaiAl lowed Values ’ sixeof( BitGrpEntry ); 

If tvalueHem < kMewLimt) I 

// Alloant memory for the UitCirpEntry's 

gBitGrpLists ■ (BitGrplEntryPtr*) 

NewPtrCvalueHea f 32 • gNuroBitGrpBlocks}: 

// ?iucc(rssfijl aJlocation? 

if CgBitGrpLists) I 

gFirstFreeEntry ■= {BltGrpEntryPtr) 

igBitGrpLlsts [ 8 * gNumBitGrpBlocks ]; 
return kNoErr; 

} 

I 

I 

I 

switch (chunksize) I 
case 1; 

if (RpHTCount>'’l II gBlockNumAl I owed Values i 4) t 
gBlockNuuAl lowed Values = gNuaiAllowedValues; 
spliiCouni = 0; 
chuxU^Size “ 2 : 
continue; 

I 

case 2: 

If tap] ltCouiit>^2 II gBlockNunAl lowed Values < 4) ( 
gBlocNNunAlloweiiVnlues ^ gNuMAilovedValues; 
spUtCouni *■ 0; 
chunkSiae ” 4: 
continue: 

I 

case 4; 

if (splitCount)“3 | | gBlockNuniAl lowed Values ^ 4) ( 
gBlockNumAllowedValues ^ gNumAllowedValues: 
npHtCount 0; 
chuiikSize 8 : 
continue: 


I 

gBlockKnaAn owed Values 2; 
aplltCount++; 

\ 

return kErr: 

I 


MakcCompIcmcm 

// if the number of xUowcd v'ulucs m the input exceeds tudf the maximum number of 
// aUowtd values (plus some sbek), the number of toIikis that arc not in the 
// gAllowedValues array arc calciilaicd ami replace the values in gAUowedValues. These 
// values arc then to be denied; 

// 


void MakeComplementf void ) 

I 

ulng *hitMap; 

ulng nuniLongs = (IL « gNmnBits) / 32; 
blLHap = (ulng*) NewFtr{ 4 * (numLongs +8)): 
if (bitMap) ! 

// (Tear hitMap 

ClearMemory{ [long')bltHap* fniiniLongs ^0) / 8 ): 

// For every allowed value set its bit in biiMap 
uing *pastVal=tulng*)&gAllovedValues IgNmaAllowedValuEsl; 
ulng *curVal = {ulng*)gAllowadValnefi; 

do I 

bltmpt*curVal>>3l |= (IL « fcurVal £• OxOOOOOOlf)): 
curVal++; 

I while (curVal 1= pastVal): 

// tkicrmine the values to be denied by kxjfcing for 
// i) bits in bitMap. Write them out to gAllowedValnes 
ulng *curEntry - bitHap: 
ulng cnrlndcx: //intobitMap 
ulng curBit; 

cucVnl ^ Culng*)gAllowedValueE: 

for (eurindsx ■ 0: curIndex<nuniLongR; eurTndox’H-) [ 
if (*curEntry t= Oxffffffff) ( 

for (curBlt - 0; curBiL<32; curBlUH^) [ 

If {{^curEutry h (IL << curBit)) “ 0) I 
*curVal (curifidex « 5] | curBit; 
curVal++; 

1 

1 

I 

CurEntryi-*-; 

J 

// Sd the new number of values in gAUowedValues 
// and flip the gAIlow^ varia!)k fnim kABow to kDeny 
gNumAllowedVaiues * curVal - (ulng*}gAllowedVslues; 
gAllow “ kDeny; 

DisposPtrf (char*) bltMup J; 

J 

1 


rnitRitGrpTlsts 

// Imtialixatiun of the internal lists by reading values fnun gAlks wed Values and storing 
// them as BitfirpEntry items. 

// 

void TnitBitGrpListsf long startValue. 

long pastValuG ) 


I 


long ‘curVal “ SgAllouedValues[BtartValue]; 

long ‘pastVal - AigAll owed Values [past Val ue ]: 

BitGrpEntryPtr curEntry " gFiruiFreGEntry; 
BltGrpEntryPtr ‘curHesd; 


ClearMeitcryC (long*)gBitGrpListS. gNuoBitCrpBloeks ): 


// Two rimes the same while kwp. Once for the special ease of ehnnkSi^fc = I and 
// then for the general ease of diunkSizc = 2, 4 or 8. Only the chiinkSize = 2 ,4 
// and 8 cases need gBitOrpMapper's IjookUp method since these cases deal with 
// base 5, 5 and 9 integers, lespcctively. 


if (gBilGrpMapper.ehunkSize =1) I 
whllu (curVal < pastVal) [ 

gEitGrpLists 1 *curVal ] “ curEntry; 
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ciirEmry >nD)tt NUTX; 
curEntry ^valu? = 'curVali 
€ur£!itry->nask - gStartHaskr 
curEntry-H-; 

ciirVal++: 

I 

^ else I 

wlille (curVfll < pastValJ I 
curlleed * 

&gBltGrpLlsts[ gBitCrpHappet.Lookup{ 'curVal ) ]; 
curEntry->next " ‘curHead: 
cutEatry’>vaiue *curVai: 
t!iirEiitry->iBask = gStartMask; 

•rtjrHead - curEntry; 
curEfU ry++: 
corVal-H^; 

1 

I 

gNuTnValuefllnListE = pastValye - startValue: 


(3carMtnKJTV- 

// linforiutuicly t don't know tlic PKJ pfoci-ssurs wd\ enough to kntm wherh^r thtr 
// way thin JiKip b onruikxl rt'aJJy mticJt. 


// 

void ClearHenoryt 

I 


long 

long biockCoimt ) 


while (blockCouni ) E 
•p - NULL: 
p-H': 

•p - NULL: 

p+i; 

*p - NULL: 

p-H-: 

> - NULL: 

p44'; 

♦p - NULL: 

P++: 

’p = NULL: 

pU: 

*p - NULL: 
p+^: 

•p = NULL; 

P++; 

I 

I 


Ad<fJ'oOiitpu( 

// Add a valw for which no hiKidv' can be found m the output arrav. 

// 

inline void AddToOutputf BitCtpEuLryPtr ourEntry ) 

I 

if (gRulesLeftJ E 
//Add to output rides 

gCnrRulfi->value = curEntry'>value; 
gCurRu1e->ifiask = rurEntry >ntask: 
gCurRule >alIow -- gAllow; 
gCurKule-H": 
gRulesLeft^; 

J 

1 


ProccTSS 

// Entry point for the main processing ItKip, If there b enough tnemury, all die available 
// values arc eonsidcred at the same time, Jf memory Ls low, the input v'alues arc 
// pmecssed in hlixki: of site gBlotkNumAllowcdValues 0ikcW to produce a hiper 
// numiK'r of output rules). 

// 

ErrCode Process( void) 

i 

long nunVal Lien Loft = gNiuDAllovodValuea: 
long StartValue “ 0; 
long puuiValue " 0; 
while (nmnValuesLef l) t 

pastValue += gBlockNunLAllowedValues: 




pofson 

"'■gB?” = 

PowerPlant 

X ^ 

^ O 

^ SYMANTEC 

O '’^o.eee,, \ 
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and generate “human, professional qualit\' code ” 
to implement your design. 
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if (paatValue > gNumAllowedValues] I 
pastValue ^ gNumAllovedValues; 

J 

InitBitGrpListg( startValue* pastValue h 
FrocessLiata O; 

if (gRulesLeft <= 0) return kErr: //Uulput array full 
nunaValuesLeft = pastValue - startVaiue: 
BtartValue ^ pastVaiue: 

) 

return kWoErr; 

1 


PmccssUsti 

// IjfKip over gBitCrpLists while ihcn: itt: v;4luo lo ecmbinc, 

// 

void FrocessLists( void ) 

I 

while (gNumValuesIriLiatsJ I 

gKumValuesTnListS KemoveValues()^ 


RcJiJuvcVaJuo 

// One loop over jjBittirpUsis, comhlnlng pairs of values rhat differ in exactly ouc bit If 
// far 1 given value such a compatible value is found (refemd to as 'buddy’ in many 
// places in tbe code), they are combined. This is done by throwing away' the value 
// that has a ’ I ' in the bit position that differs and then eleailng the same bit in the 
// remaining value's mask. 

// 

long R;eDoveValue&( void ) 

1 

long valunsReaioved 0: 

long curTdx “ Oj 

BitGrpKntryPtr be^foreEntry: 

BitGrpEiitryPtr curEntry; 

BltGrpEntryPtr 'curList “ gBitGrpLlsts; 

BitCrpEntryPtr /pastList ^ 

&gBitGrpLists [ gBitGrpMapper,nuinGrphiiJts li 

if CgBitGrpMapper.chunkSiise = 1) 1 

while CcurList < pastbist) [ 

If t'eurList) I 

beforeEntry “ (BltGrpEntryPtrJcurl.ist: 
curEntry = *curList; 

RemoveLooplBitC curldx, beforeEntry* curEntry ): 
va 1 ue sReajo ved ^-+: 

I 

curList-H-: 

curIdK++: 

1 

1 else f 

while (curList < pasiLlst) [ 
if f‘curList) I 

beforeEntry ^ (BitGrpEntryPtr)curListi 
curEntry * ‘curLlst: 
do I 

RemoveLoopC curTdx, beforeEntry, curEntry ): 
valuesReinovedl+: 

if (beforeEntry >nexi = curEntry] [ 
befotGEutry curEntry: 

1 

curEntry ” curEntry)next: 

I while (curEntry): 

) 

curList++: 
curldx+f: 

1 


return vaiuesRenitived♦ 

1 


RemoveLoop 

// Remf>vel4x>p deals with ehunkSirc ^ 2. 4 and B. This Inunction lm>ps over 
// curEntry's buddy lists (lists Uiai may cotiuin values that, compared with the value in 
// curEntry f differ in exacily one bit). 

// 

void RemoveLoopt long curTdx, 

BltGrpEntryPtr beforcEniry, 
attGrpEntryPtf curEntry ) 

( 

short curCbunk = gBitGrpHapper,chunltComit: 

ulug mask = gBltGrpMapper.firstMask: 

ulijg lEfltchBit gBitGrpMapper. firstMatchBit: 

long raagidx curldx: 

long nagStep; 

ulng scanVal i 

BitGrpEntryPtr *bLtddyLisL; 

while (eurChunk) I 

scanVal curEntry->value & "^ask; 

magStep = gBitGrpMapper.lbTable[curChunk]: 

if (magidx < gBltCrpMapper,ubTabletcurChunk]) I 

buddylJst = frggltGrpListsl curldx + magStep J: 

If (*buddyLlat) I 

if (ScaiiAndReinove( curEntry, 

(BitGrpEntryPtr)buddyList, "-mask* iuatchBiL )) I 

return; // Found a 'buddy' 

I 

1 

I 

if (nsagidx >*“ magStep) 1 
buddyList - &gBitGrpLists[ curldx - nagStep ]; 
if (‘buddyList) t 

If (ScanAndkeepC curKniry, 

(BitGrpEntryPtr)buddyList, "Tiiask, matchEit )) I 

// reimivc curEntry from list 
beforeEntty->nftxt * curEntry->iiext: 
return: // Found a buddy' 

I 

I 

do 1 

magidx -= magStep: 

1 while (magidx >“ magStep); 

I 

Eiiask gBltGrpMapper , chunks Sxe; 
natehBit >>= gBIlGrpHappcr,ehutikSlxe: 
curGhunk-; 

I 

// Nf} match found ■> add to output and irmcjvc fri»ni list 
AddToOutput( curEntry ); 
betoreEntry->next " curEntry >nGxt; 


RemoveLtxjpiBlt 

//The 1 Nt only version of RcmovebxipO 
// 

void RemoveLooplBlt ( ulng curldx, 

BltGrpEniryPtr befoteEntry, 

BltGrpEntryPtr curEntry ) 

I 

ulng matchBit = gBitGrpHapper,firstMatchBit: 

flitC r p Ent ryFt r * bu d dyH e ad| 

while (matchBit) I 

if (etirldx & tnatchBit.) [ 

if {buddyltuad ” ^gBitCrpListsl curldx k '-matchBit 1) I 
if ((‘buddyHead)->mask “= curEntry->aiaEk) 1 
t*buddyHead)->iaask "laatchBit: 
beforeEntry->next " KtlTJ.; 
return: 
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i 

i 

} else f 

if (buddyHead = ^gBitGrpLietsl curldx | uiatchBit J) 1 
If C (*buddyHead) >imsk “ cur£ntry '>niaskj I 
curEntryOmask ^atchBit; 

*buddyHead * NULL: 
return; 

) 

1 

I 


oiatcbBit »- 1; 

1 

AddToOutputt curEntry h 
beforeEntry->next - NULL: 

1 


ScinAndKccp 

// J^or a given value, scans thnnigh a group M and searches for a buddy for that value, 
// If a buddy is founds comparcEntry will be removed by Remove Valued. 

// 

long ScanAndKeept BitGrpSntryPtr compareEritry, 
BllGrpEntryPtc befoceEntry, 
ulng mask* 

ulng matchBit ) 

[ 

BitCrpEutryPtr thleEntry = beforeEntry->next: 

ulng scanValue ^ compareEntry‘>value & mask; 


while (thisEntryJ I 

if ((thi^Eiitry->value t mask) “ scanValue) I 
If CconipareEntry->tiiask ^ thiBEntry->iiiask) { 

if (Matcht compareEntry* tbisEntry, matchBlt)) i 

thisEntryOmask &= "*(conipareEntry*>value * 
thlsEntry->value); 
return 1 ; 

] 

1 

1 

beforeEntcy = thisEntry: 
tbisEntry - thieEntry->next: 


return 0; 

1 


ScanAndRcmovc 

// Same as ScaiiAndKcepO except that if a buddy is found, it is removed after the 
//compareiiniry's mask has been updated (sec RcmoveValucsQ). 

// 

long ScanAndRemove( BltGrpEntryPtr cotnpareEutry, 
BitGrpEntryPtr beforeEntey. 
ulng mask* 

ulng matchBit ) 

I 

BltGrpEntryPtr thisEntry = beforeEntry->next: 

ulng scanValue ^ compareRutry-yvalue & maskj 

while (thisEntry) [ 

If C(thisEntry->value & mask) “ scanValue) I 
if {conipareEntry->ntask ” thisEntry->iiiask) { 
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if (Hatch( ctssiparcEnlry, thisEntry, matchBit)) ( 

cowpareEmry >tiask ^ '^CcolDpar^»E^ltry >yaiue * 
thiflEnuy >vaiue): 

beforpEntry >next ^ thisEniry >next; 
return 1; 

I 

I 

I 

beforeEntry - thlsEnlryj 
thisEntry = tbiaFntry->next: 


teturn 0; 

) 


If (gRulesLeft > D) t 
gCurRiile->va1ue 0^ 
gCurRule->»ask = 0; 

If CgAHow -- kAlIqw) I 
gCiirKule->aliow “ kDeny: 

) else f 

gCurHule->allew - kAnuw; 

1 

gRuIesLeft-; 

return gMaxKuleu - gRulesLeft: 
1 else ( 
return 1: 


Match 

/J Tlic iwu v’Jucs cc>niparcFjirry>valuc and tbisFjnry'>valiic can be cumhitMxl if they 
// ditTcr in exactly one hit. In ilwiit cjuscs, rciVaJ. below; will have exactly one hit set. 

// llie rest of the cixle tests to sec If that b so, I have the fceliiig that this ftint tion's 
// efTiciency emtid be improved. 

// 

inline long Hatch( Bitf^rpEntryPtr compareEntry. 

BI tGrpEntryPtr thlsiEntry, 

^ ulng malcliBit ) 

ultig refVnl * coinpaEeEntry->value ^ thisEntry->va 1 uei 
ulng aiateliCount ^ 0; 

switch (gBitCrpHapper.rhurikSlxe) I 
ense 2t 

If {t CrefVaT * aiiitchBit)} return h 
matchSit >>= ii 

if (1 (rcrVul '' inatchBit)) return Ij 
return Oj 
cane 4: 

K (! (refVal ^ natchBit)) return 1; 

SHiltcbBlt >>** l! 

it (! (refVal * raatL-hBit)} return li 
matchBlt >>'^ 1; 

if (I CrerViil ^ tnatchBit)) return 
matehRlt 1: 

IF (1 (tefVal ^ matchfliO) return 1 : 
return Q; 
euse 8: 

if (! (refVal ^ inatchBit)) return 1; 
natchfilt >>-" 1: 

if (! (refVal * oatebBit)) return 1; 
matchSit »' 1; 

If (I (refVai * natchBit)} return 1: 
nuitehBit »- t: 

if (I (refVal * tiiatcii8it)| return I; 
inatchBit »” i; 

it (I (refVal roatchBit)) return 1; 
matchBit »- 1; 

if (! (refVal raatchBit}) return I; 
matchBit >>" 1: 

If (1 (tefVal ^ matchBit)) return U 
wauhSlt »“ 1; 

if (! (refVal ^ mstchBlt}) return 1; 
return 0: 

I 

return 0; 


// Main cntiy point 
// 

long RouterRules( 


I 


long 

long 

long 

Rule 

long 


allowedValues[1 * 
numAllovedValues, 
nmaBitfi* 
rulesArray0 * 
ntaxRulea ) 


gAllowedValues ^ allowedValuear 

gNiunAIlovedValues = nitmAnDwedValues: 

gNumBits ^ numBits; 

gCurRule = rulesArrayj 

gHaKRuies = maxRules: 

gRulesLeft ^ rauxRules; 

gStarrHask - Oxffffffff » (32 gNuraBits): 
gAllow " kAllow; 


If (maxRuies C- 0 } return 1 ; 


if (numA11owed Values <= 0) i 
gCnrRule >niask = 0: 
gCiirRule >vaiue 0: 
gCnrRulc >allow = kDeny: 
return 1; 


if (numAllowedValues ^ (IL « numfllts)) 1 
gCurRule->iiask - 0: 
gCurHule>value = 0; 
gCurRule >ailow “ kAllov; 
return 1; 


Routcrftnlcs 


tfif AkTER^INPUT VALUES = 1 

If (numBits > S 44 numBits C 32 44 numAllowedValues > 
( (lL«(mimBits-J)) + (1L«(nnmBitii b)) )} \ 
MakeComplemeiitO; 

} 

ffendif 

if (initO ^ kEtr) rerurn 1: 

Process{): 
return CleanUpO: 


(llcant fp 

//1 first drt e lopped ihLs s^dution iiKiog the Syniiintec envirtmment whea* 1 und the 
// f:++ m w and deJete fnm‘tions for ttiunoy manaijemcnt After moving to 
// QjdcWajTitik iKwever, 1 hatl to use the Mac TooJIw™ hmetion Newftrto allocaic 
// metrKny in InitQ (tml iJispusPir ui dbip<i,'ic of it here) because (kKkwarriof's 
// implemetitatron of new didn't seem to mliahfy return I'iUli in cases a niemon' 

// rctjnest cimkl mn he saibfiaK 

// 

long Cleanup( void J 
I 

if CgBitCrpLlsts) DiSposPtr( (charMgHitCrpListS ); 




visit MacTech Magazine’s Web site! 
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Bn^jKPMAPPER.CT 

//- 

// [mplcntenunkin of dass RitGrpMappcr ■ a class Utat docs most of the base 2, 3, and 
// 9 afiihmctk 

//--- 

#dt>finc WRITE LOOKUP^TAflLES 0 

#if yRlTK_LOOKUr_TABLES — 1 
# include <stdlibdi> 

9 include <fstreaiiiJi> 

Ifpnrilf 

^include “BltGrpMnpper.h** 

long BltCrpMEippen tuhTeble[33 J = I i) I; 
long BitGrpMapperj:lbTablef33l - I 0 h 

void BitGtpMepperi linitt long ehimlcSz* 

long numBits ) 

i 

switch (chunkSz) ( 
case 11 

lookupTtiblo " NllLL; 
firstHask ^ 0x01^ 
firstMatchBit - 0x01 1 
break; 

cefio 2 ; 

lookupTable lookupTable2: 
flrsrMank ” 0x03; 
firstHntchBft * 0x02; 
break; 
case 4; 

lookupTable ” lookupTable4: 
firstMask * 0x0f: 
flratHatchBit “ OxOS; 
b reek; 
case 3; 

iookupTablc " lookupTableB; 
flrstKaak = Oxff: 
flrstKatchfll t QxBO; 
break; 

] 

// Okrubte the upper htxuid and lower lx>iind lookup tables used in RemoveUx^ 

// of RoiiicrRuics.cp 

chunkSize = chunks?.; 

chunkCcunt = numBits / chunkSz; 

long exeessDita = nunftitfj % chunkSz: 

if CexcessBits) chunkCaunt++; 

rirstKask <<- ((chunkCoutil 1) * chunkSz): 

firstMatchBit <<» ((chunkCouut IJ ‘ chunkSz); 

ulng base = chunkSz i L; 
ulng curBaso I j 
long i: 

for (i“l; l<chunkCoynt: i++) 1 
IhTahlefil curBase; 
uUTabln[il “ chunkSz * curBase; 
curBasc base; 

1 

lbTable[il = curRase; 

if CexcessBits} ubTable[l] ^ excessBits * curBase; 

else ubTableEl] * chunkSz * curEase; 

nuraGrpLisis ubTableti] + curRaae; 

#if WR1T£_LOOKUP TABLES 1 

I 

IndexEniry twpTahlef256l; 
ofStream file; 

file*open( '‘BltCrpliapperTablnB^cp" >: 

file << “^include \*BitGrpMapper.h\'*“ « endi « endl: 

Ca1cf.ooku pTa ble( t up Ta b1e, 2 ): 

WcitcLookupTableC file, tmpTable, “!ookupTable2** ); 

Ca1ebook u pTa b1e{ tmpTab1e» 4 ): 

WriteLookupTablet file, tmpTabie* “lookupTableA’* ); 
CalcLookupTable( tmpTable* 8 ): 

WriteLookupIableC flic, tmpTable, “lookupTableB'* ): 



Bug Tracking the Macintosh Way 


1 - 2-3 Start Tracking 

TeslTrack is rsady to use 
rigtitoutoflhcbox— 
simply iitslall, add a few 
usen, and start tradcuig. 

llmt easy. 


TeslTtack is more than an e^-lo-use bug tracking program—ntk a powerful quality conlrol 
tool for busy software development teams' 


Automate TbslTrack automates the 
tedious and error-prone process of 
reporting and hacking bugs by lianri U 
also diminaias the need to create a 
custom solutjon using general puqmse 
database tools such as 4D™ or 
FileMaker Pro"*. 

Stay up to [late Tesflbck lets any 
autliorized user \o(k up thecummt 
state of any defocl at any time 


Comifiunicate TestTrack links engineers, 
lesteis, managers, even tedi writers together 
so no one falls out of the loop. Team 
inerabeis are notified automatically when 
defects are assigned lo thenj, guaranteeing 
communication and ensuring efitdent work 
How, 

Analyie TtetTyKkniakcjrepoitmgeasy— 
point, dick, print and read Customize 
repans u> list wbal you want to see 


For d Itmited liiiie, you can biiy TcsfTrack for the introductofy price of S99^ 
Volume pricing, anil sile Uccn$es are also available. 

To order call 513-683-6456 

_ Seapine Software, Inc. 1066 Seaptne Ct. Mainevllle, 011 45039 


sales ©seapine.com 

^ Seapine 

http://www.seapine.cDm 

^Software 


IW4.t ^0^ 


f«y^rofti 

fipy«rs 

Otives 
MciKraoitt 
Extra Cheexx 


^Or- 


’“C: 


Deciding on your development 
tools should be this easy too... 



Details at... 


Integrated Development Environment 
Quasar Krvowledge Systems, Inc 

( 415 ) 728-5333 fax; { 415 ) 728^1757 info@qks.com 
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file,close 0: 

I 

jl^endif 

I 

hf WRITE LOOKUP^TABLKS = 1 

void BiTGrpHapper:iCaicLcokupTablef ladexEntry lookupTbl[J* 

long chunkSz ) 


BitGrpMapper.h 

// ctass BitGrpMappcr 

#ifndef NULL 

const void * const NULL = 0; 
#endif 


long 

long 

long 

long 

long 

long 

long 

long 

long 


iookupByter //0^255 

byte InLong i // 30^ 0 for the most sig. byte 

ebunkCounr 8 / ebunkSz://8,4,2 or 1 

c u r Ch un k: // th. chunkClemnt* I 

b 11 Co ufi t s [ B1 : // bitQmnLsJO]: right most chuiik 

curfiit: // bit 0 .. bit 7 (ri^t to left) 

b i 11 ndex: // 0.. chunkSzd 

base * chunkSz + 1; //base 2, 3s 5, or 9 

curBase: //apowcrtifbsiM: 


for {lookupByte“0; lookupfiyte<25B: looktipByte++) ! 


curRit 1: 

for (curChunk”0: curCliimk<chuiikCount; curChuiik++) { 
bitCountBlcurChunk! ^ 0: 

for (bltlndex“0i bitTndex<cbtitikSz: bit Index H) l 
if (lookupByie & corBit) bitCouiitsfcurChiink]-H-{ 
curBit «- li 

I 


curBase " 1; 

for (byteInLoiig“3: byteTnLong>=0: byteInLong-) \ 
lookupThl flookupByte] ,iiidex|byteInLongl = 0: 
for (ciirChunk“0r cnrChniik<cbiinkCount; cnrChniik-H') \ 
looktlpTbl [lookupByteJ, index fbytelnLong] += 
curlaae * bitConnts[curChunk]: 
curBase '= base; 

J 


I 

i 

void BitGrpMapper:tWriteIookupTable( ofstreant &file, 

ItidexEntty table [j , 
char* tableNante ) 

f 

long entryCoutit: 
long indexCount i 


typedef unsigned long ulng: 

struct IndexEntry f 
»»long.* Index[4]: 
h 

class BitGrpMapper 
public: 

static long .»ubTable[33j ; 
static long ,.IbTablel33j: 

1 ong ehunk^ize: // 1. 2s 4 or 8 bits per chunk 

long chunkCount: // * of chimk.Vdlgits in group index 

ulng fir stNask: // used to reset curMasL 

ulng firstW^tchBit; 

long nunGrpLists: 

void.- .,Jnit( long..chunkSize* 

long. .nuaiBitff )i 

inline long LookUpf ulng value ): 
private: 

static IndexEntry lopkupTableZ[]: 
static IndexEntry lookupTable4i]; 
static IndexEntry lookupTableBrj : 

TndexEntry '1 ookupTable; //kxikup group index 

WRITE_LD0KUP TABLES -» 1 

void CalcLookupTable( IndexEntry lookupTbl[]* 

long chunkSz ); 

void WrlteLookupTableE ofstreara 

IndexEntry tableLJ. 

char tableName ); 

tfendif,. 


inline long BlrCrpMapper; : LookEJp{ ulng. .value ) 
long..Index - lookupTable[value >> 24].1ndex[0]; 


file « “IndexEntry BitGrpHapper: 

« tabloNaiEe << “l25b] " « endl; 

for (entryCount*0: entry€ount<2S6j entryCount-H-) ( 
file « “ I 

for {indexConnt“0r lndex€ount<4: indexCountH) i 
// hinting as pointer to long writes value as a four byte hex number in the 
// Symantec environ, Not so with my brand new CaitkWarrior (at least using the 
// default project settings). Would need to be fixed if the lookup tables had to l>e 
// rebuilt, 

file « (long') table [entryCoittiLj .indexUndexCount]; 
file << ((indexCount ” 3) ? " ]" : “); 

1 

file « ((entryCourU = 255) ?*':',')<< endl: 

I 

file << ’^1;" << end! << endl: 

I 

#onclif 



Want to know what products are 
available for MacOS 
development? Checkout 

Developer Depot™ <http://www*devdepot,coin> 



index += lookupTablel(value » lb) & Oxff].indextl]: 
index lookupTablef (value » 8) 4 Oxff j,IndexUl; 
index +- lookupTable[value 4 OxffJ.indexl3]: 

return index; 

I 

P»ovidedCodk-h 

// Caxlc copied from problem statement 

eriuiii [ kDeny - 0^ 

kAlIow 1 

1* 

Jifdef _cpluspltjs 

extern “C" ( 

#endif 

typedef struct Rule ( 
lung nrnsk; 
long value: 
long allow; 

1 Rule; 

long RoutcrRules( long allowedValues(|. 

long nuttAllowedValues, 
long nunaBH&i 
Rule rulcsArravij ^ 
long tuaxKules J; 

#ifdef _cplusplus 

1 

fendif 
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BitGrpMapperTabl 

ES,CP 

#inc1ud e * BixGrpMa pp e r.h“ 


IndexEntry BitCrpHapper j ;lookiipTahle2 [256] = I 


( 0x00000000, 
I OxOOOSIEFi, 
\ 0x0008IBFl, 
1 0x00103/E2, 
i 0 XOO 1 & 53 O 3 , 
\ OxOOZOOFC^. 
1 0x00206FC/j, 
i OxOOaSSBBS. 
i 0x001fi53D3, 
I Ox00206FC4, 
( 0xO0206t'C4, 
( OxOO280BB5. 
I OX0030A7A6. 
[ Ox003SC397. 
{ 0x00380307, 
i OX0040DFBS, 
1 0k0Q4SFB79. 
i 0x0031176A, 


0x00000000. 
DX000019A1. 
0x000019A1. 
0x00003342, 
OX00004CE3. 
0x00006684. 
0x00006684, 
0x00008025. 
OkO 0OO4GE3, 
0x00006684, 
0x00006684. 
0x00008025. 
OX000099C6, 
OxOOOOB367, 
OxOOOOB3fi7, 
OxOOOOCDOB* 
OxOOOOE6A9, 
0x0001004a. 


OxOQOnoOQO. 
0x00000051, 
0x00000051, 
0X000000A2. 
OXOOOOOOF3. 
0x00000144. 
0x00000144, 
0x00000195. 
0x000000F3, 
0x00000144, 
0x00000144. 
0x00000195, 
0x000001E6. 
0x00000237, 
0x00000237, 
0x00000288. 
0x00000209. 
0x0000032A. 


OxOOQOOODO 1 
0x00000001 I 
0x00000001 1 
0x00000002 i 
0x00000003 ] 
0x00000004 ] 
0x00000004 ) 
0x00000005 J 
0x00000003 1 
0x00000004 I 
0x00000004 I 
0x00000005 I 
0x00000006 I 
0x00000007 I 
0x00000007 I 
0x00000008 J 
0x00000009 J 
OxOOGOOOOA \ 


[ _ and Bore ’ see online archive for complete file] 


f 0X02809F5F. 0x0007E8AF. OxOOOOlBFF. 0x0000O04F J, 
1 0x02888850. 0x00080250. 0x00001950. 0x00000050 1 


1; 


IndexF.ntry BltGrpMappcr: jl£>okupTabie4 [256] == i 

OxOOQOOOOO. 0x00000000. OxOOOOOOOO. 0x00000000 
0x00003009. 0x00000271. 0x00000019. 0x00000001 
0x00003009. 0x00000271. 0x00000019. 0x00000001 
OX0OOO7A12. Ox000004E2. 0x00000032. 0x00000002 
0x00003009. 0x00000271. 0x00000019. OxOOOOOflOl 
OX00007A12. 0x00000482, 0x00000032, 0x00000002 
Ox0OOO7A12. 0x00000482. 0x00000032. 0x00000002 
0xD000B7lR. 0x00000/53, OxOOOOCD4B, 0x00000003 
0x00003009. 0x00000271, 0x00000019, 0x00000001 
OX000O7A12. OX000004E2, 0x00000032, 0x00000002 
OX0OOO7A12. 0X00O004E2, 0x00000032. 0x00000002 
0x00008718. 0x00000753. 0x00000048. 0x00000003 
0x00007Al2, Ox000004E2, 0x00000032, 0x00000002 
0x00Q0B7lB. 0x00000751, 0x00000048. 0x00000003 
0x00008718. 0x00000753. 0x000DO04H. 0x00000003 
CXOOOOF424. Ox000009C4. 0x00000064. 0x00000004 
0x00013120. OxOOOOOC35, 0x00000070, 0x00000005 
[ „ and nvore - see online archive for complete file 
0x00057BCF. 0x00003827, 0xOOOOO23F. 0x00000017 
0x00057BCF. 0x00003827. Ox000002lF. 0x00000017 
Ox0005BaD8, 0x00003A9a. 0x00000258. 0x00000018 
I: 

Tndo.xKnlry BitGrpMapper: :lo<ikupTable8[256j = ( 

■ 0x00000000, 0x00000000. 0x00000000. 0x00000000 
0x00000209. 0x00000051. 0x00000009, 0x00000001 
0x00000209. 0x00000051. 0x00000009. OxOOOOOODl 
Ox000005B2. OxOOOOODA2. 0x00000012, OxOOO0O002 
0x00000209, 0x00000051. 0x00000009. 0x00000001 
Ox000005B2. OxOOOOOOA2. 0x00000012. 0x00000002 
OX000005B2, OxOOOOOOAZ, 0x00000012, 0x00000002 
OxOODOOBBB, OxOOOOOOFJ. DxOOOOGOlB. 0x00000003 
Ox000002D9. 0x00000051. 0x00000009, OxOOOOOGOl 
0x00000582, OXOOOOOOA2. 0x00000012, 0x00000002 
0x00000582, OXOOOOOOA2, 0x00000012. 0x00000002 
OxOOOaOSSB. 0x00000073. OxOOOOOOlB. 0x00000003 
Ox000005B2. OxOOOOOOA?, 0x00000012. 0x00000002 
OxOOOOOBBB. OXOGOOOOF3. 0x0000001B. 0x00000003 
DxO0&0088R. OxOOOOOOfI, OxQOOOOOlB. 0x00000003 
0x00000864. 0x00000144. 0x00000024. 0x00000004 
0x00000209. 0x00000051, 0x00000009. 0x00000001 
0X0000O5B2, OXOOOOOOA2. 0x00000012. 0x00000002 

L - and more - see online archive for complete file 

■ OX000013EF. 0x00000237. OxOOOOOOIF. 0x00000007 
0x000013KF, 0x000002-37. OxOOOOOOIF. 0x0000000/ 
0x00001BGA. 0x00000288. 0x00000048. 0x00000008 


WINREZ 

Don’t rewrite your apps. 
Port them! 

WinRcz is a complete emulation 
of all Resource Manager and 
Memory Manager routines. 

Read/Write/Create your rez 
forks in your Windows apps. 

String resources and rez fork 
chaining fully supported. 

WWW.PARTIUM.COM 


Want to share a 
tip with the community 
and get paid for it? 
Send it in to 

<mailto:tips@inactech.coin> 
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GAME 

DEVELOPMENT 


By Jamie Osborne, Apple Computer, Inc, 



Shift into High Gear with Apple Game Sprockets 


Turning your game idea 
into a reality^ step by step 


In ti!e Beginning, 

There was a Cool Idea,** 

So, you want to write a cfxil game for 
the Macintosli. Well, you're in luek. This 
aitielc will take you step-by-step through 
the whole process, l^egtnning witli an idea 
for a game, ail tlie way to playing wiifi your 
friends over a network. It will deal with 
loading and blitting sprites to the screen, 
getting input from any input device, no 
matter how snazzy^ generating sounds that 
arc correctly attenuated for distance and 
location, and doing all the work necessary 
to play your game over a netwoi k. 

If tlmt sounds like way too much to 
cover in a single MacTeeh article, yoidre 
right. At least, you would have laeen right if 
this artit:le were written a year ago. Since 
the advent of Apple Game S[>rockets, it is 
now^ possible to discuss everything you 
need to know' (with a small amount of 
strategic gl os sing-over) in the space of a 
single article. 1 won’t be able to delve 
deeply into each of tlie Sprockets, but that’s 
OK because LI lore’s an on-line reference 
manual for that. I’ll also gloss over some of 
the details alxiui how to do things, such as 
how to load or store resources, or what 
goes into the application shell. However, 
the entire source for the game T will 
develop here is available witlj tliis issue’s 
C(xle disk, as well as on the Internet, 


Now, what game am I going to do? A snazzy 3D biotxl bath 
like JVIarathon? No. A multi-player flight simulator that can have 
hundreds of people playing together over the Internet, a la 
Warljirds? No. 

I am going to start off with something that has proven 
game play, yet is straightforward enougli ihai I can actually get 
it dt>ne. I am going to do a game called “Sprocketlnvaders,’' 
Why? For two very good reasons. First, it*s doable. For every 
game that you've .seen on the store shelves or in the shareware 
seaion of INFO-MAC, there are a dozen otiier games dial were 
started with tlie Ix^st intentions but never completed. Many of 
us have had good ideas for game.s, Some of us have even 
started games ourselves. However, very few of us have ever 
finislied writing a computer game. Tiiercfore, I am going to 
write something that 1 know I can do in a reasonably small 
period of time, llie second reason is tliat despite (or perhaps 
bet:ause of) the faci that it is a very simple g^amc, it lends itself 
very well to showing off the different areas I am concentrating 
on - rendering, sound, input, and networking. 


Si'BF One — Design 

Designing SprocketJnvader.s was greatly aided by die fact 
that the Hnvaders" game archetype is firmly estal)!isiied. Of 
course, you must make your game sufllciently unique so tliat 
you don’t violate anyone's copyright. My design was pretty 
easy. 1 knew that 1 wanted aliens that mtwed in die invader 
style. 1 wanted a .ship that would l>e able to move left, move 
rrgliL, and fire, I wanted the waves to get progressively harder 
by speeding up the rate at which the aliens moved and fired. 

When you're starring a new game, it's easy to get bogged 
down in over-design. With Sprocketlnvaders that was not a 
problem, but with something more complex, perhaps a game 
where each level inuoduced new aliens or weapons, you might 
find yourself spending a whole bunch of time designing and 
not much time implementing. Of course, designing before 
implementing a game, or any software for that matter, is better 


Jamie Osborne is the manager of Applet Game Teclinology Group, which creatol the Apple Game Sprcxkcls. He enjtiys the 
fa a that he cm play games and gel paid for it. 
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than iniplenienting first and then designing as an aftcnJiougiit. 
Again, the best way is to set attainable goals, achieve tliose 
goals, and build on your sua:ess. Design your game with one 
Icveh gel it all running, then u.se your success to work on more 
sophisticated features or levels. 

Step Two —The Shell 

The best way to begin any new game is to start with a 
gfxxl application shell. 'I'his is rme on any platform. Over the 
years, thousands of people have written thousands of Macintosh 
applicatioas, nearly all of wliich had the same design. 

• initialize the Toollx)x and glohals. 

• Do the event l(x>p. 

• Quit. 

There is much more complexity than IVe outlined liere — 
handling events, managing tiie menu bap etc. 1 have included a 
Macintosh ,shell application that is designed spec:ific:al!y for 
writing games that use the Apple Game Sprockets. It is a 
CodeWarrior project, but you should be able to use the source 
cxkJc in any development environment. You might notice that the 
shell code in SpF(x:kelIiivadcrs differs significantly from tlie Gatiic 
Shell I am providing. This Is because the shell was done after 
Sprocket) nvaders was written. Since I really want to talk about 
the gaiue itself, 1 will leave it iu you to cheek out the shell 

Step Three — Artwork 

Artwork is not really a ,stage, but more of an ongoing 
process. The better the artwork, die more impressive your game 
will look to the end user, tlie artwork for Sprocketinvaders was 
clone before the game was even started, since the main 
program!ncr’s hobby Is artwork, lie enjoyed doing iL up front. He 
is the exception. Most programmers ciinge wiien diey lliink about 
doing art for their game, and they have good reason — most 
peo[>le are not gcxid artists. 

The best recommendation r have about doing your art is 
that you fiml someone who lias at least liome talent for it. If that 
means you, fantastid tf not, you should call up friends and 
relatives looking lor someone who has a knack for it* The 
artwork in Sprocketinvaders will not likely wind up in a 
museum of tximputer arl, hut it's not tcK) shabby. If you can't 
manage to make an as good as die an in Sprocketinvaders, find 
someone who can. As a last resort, cajole them into helping you 
with promise.s of fame and fortune. Many aniateiir artists are 
willing to do it ju,si to have their name in the About box, A 
small price to pay for a better game. 

Tf you plan on selling your game commerclaily you miASt 
have your an done by someone who is a professional, or at 
least does professional'quality art. However, if you hope to 
have sc^me company publish yotir game, you might be able to 
gel away with doing your own an for the first version,s and 
letting the publisher redo the artwork. Doing that, of course, 
will cost you some of the profit. 

On the technical side of things, the spriles were drawn in a 
graphics program, tlien stored in 'SPRT resources tliat include die 


height and widtli of die spiite, as well as .st)me information alxjui 
die different versions uscxl to aniouite the sprites. 

Listing 1: Spritc-h 

ryperfiaf srruci Franiff 
[ 

Uintlfe tieigtiL, widths 
Sint16 hotX. hotY: 

UInte * image: 

I Prame. *FrameFtc; 

sr.rurt Sprite 
f 

Uliitl6 numlrames; 

FratneFtr 

\ Sprite. ‘SpritePtr: 

The Sprite structure is simply a pointer to an array of 
Frames, with a count, 'fhe Frame structure is a little more 
interesting. Tt contains the pointer to the acttial pixmap (the 
image), as w^ell as infoniuuum about the height and width of 
the sprite. Keep in mind that the pixmap is bit-depth 
dependent. In the case of SprcxiketInvaders, all of the artwork is 
8-bit, and die user’s monitor must be in 8-l)it mode when the 
game runs, or else evil things will happen. Luckily, 
Draw'Sprocket takes care of setting the user's monitor to the 
exact bit defXh and resolution you specify, so your game will 
always be guaranteed to look right. If you w^ant your game to 
be playable in several bit depths, you need to create artwork for 
all of the bit-depths rhai you warn to ,supp<m. 

You should be able to use the sprite libraries in 
Sprocketinvaders "riglit out of the lx>x” for yotir game, lliere are 
some dependencies on orher p^irrs of the code, ,such as die bliners, 
so you iniglii need to make niodifiaiUons il' you intend to deviate 
very much from Sprcx-ketlnvadei^’ sprite/grapliic routines. There 
are also some very gexx! sprite libraries avaibihle on die Internet. 

Step Four — IivriiAiizATioN 

Initializittion is one of those Things tliat should be a snap, 
right? Gall a couple of Tfx>lbox in it fiintlions, load in some data, 
and you’re done. Well, the answer is "^yes and no.'' Once you 
have a good game shell and you're fainilLar with all the different 
services you whil be using, such as the Game Sprockets, 
initialization js easy. However, the first lime can Ik^ pretty tricky, 
and there are many snares you can set for yourself by incorrectly 
initializing your game. These snares am trap you later on in the 
Ibrm of bizarre crashes or strange behavior, Tliat is wliy it is 
essential to get your initialization right. It’s the price you pay up 
front for the convenience you get later on. 

listing 2: tit^x 

main Hnippcl 

Main is whtrtr di> dl our mitializatiiin. 

ToolboxTnIt(}: 

// Make sure that the DrawSprocket and hipiitSprockct libraries are present 
if {DSpStsrtup ^ nil) 

FatalErrorC“This game requires DravSprocket : 
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Add multi pro oeesing and oross- 
network prooosstng speed to 
your appUoations today! 


S/ng/e ^1 



PowerTap™ makes your 
application the Fastestl 


PawerTap with four ^7 Muttf-Processors 


PowwrTitp wHh 12+ Networked CPUs 


An 

Execution Speecf 


RowerTop is a robust, easy-to-use software 
library used by Macintosh sofWare developers 
to make their applications lightning-fast! It greatly 
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if CiSpInit “ nil) 

FatalErrorC^This game requires rnputSprocket."); 

// Reseed the random number generator 
qd.randS^ed ” TickCountO ; 

startupHodifiers - Eventlnit{): 
gNetSprocketPreseut “ luitNetworkingC): 

MenuInit 0: 

GraphicslnltCstartupHodifiers)r 
SoundHandlerInit(startupHodifiers): 

RedbookHandlsrlnit(startupModlflers); 

The first thing you notice is that I check to make sure that 
DSpStartup and ISplnlt are valid symbols, to ensure that the 
DrawSprocket and InputSprocket shared libraries are installed in 
the user's system . \ could also do this by strong-1 inking the 
libraries when I build the SprockcLlnvaders application. 
However, doing it this way allows me to present tlie user witli a 
slightly more friendly error message than the default one, 
“Couldn’t start the application Sprockeilnvaders because an 
unexpeaed error occurred.’’ 

Input 

In addition to doing some MacOS evenL-handling stuff, \ 
initialize InputSprocket. At first glance, the code for InputSprocket 
initialization may seem utterly obtuse. However, it is not as tricky 
as it seems. 

The my Needs structure is simply a list of all the input 
elements wanted in order to play the game, For Sprockeilnvaders, 
1 need a movement axis and fire button for each player, as well as 
a key to exit the game. lix)k at the first element in llie needs fist. 

listing 5: EventHandlerx 

livenLinil Snippet 

“\pGree n Movement'♦ 

200 . 

0 . 

k IS pBlementK ± n d_Axis, 
klSpElementLabeOAxis. 

0 . 

0. 

0 

). 


'this is a pretty big structure to fill in, but most of the fields 
are used only for expert customization. For my needs, filling in 
a couple of the fields and leaving the rest set to 0 will do just 
fine. The ISpNeed structure requires: 

• The name of the a>ntrol for display in the tx>nfiguration dialog. 

• The icon suite resource id that TnputSpnx:ket should use in ilie 
configuration dialog. (You must aeate the icon and store it in 
your app's resource fork. You could just punt and specify 0 
here, telling TnpuiSpirxJcet to use ilefault ia)ns, but lhafs lame.) 

• A reserved field that should be set to 0. 

• The kind of information wanted, such as an axis, button, or 
direction pad In this exse, I want a tnie analog axis. 
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• A label telling InpuiSprtK'ker hf>w you intend k> inier|)rci the 
element — in this titsc, the X (horizonmJ) axis, InpuuSprocket 
useti this infonmtion to provide default mappings from an 
input device to the input needs. For example, a joystick's 
horizontal axis will Ixj niafifxxl to die X axis need by default. 

• Flags and reserved fields you don't need to worry alxnit. 

I set up the lesi of the needs stniauie die same- way, dien oiH 

theEtror * ISpElement_NewVirtualFroiisN<it*dstrmniInpiJts. , 

glnputElements, 0): 

IhLs turns the list of needs into an element list that f then 
pa.ss to file ISpInit funeiion. Again, diis might seem like excessive 
work to set up input, but die reason 1 have to do so muc:li licrc is 
that InputSprocket is extremely flexible. It needs to Ix^ able to 
siippon input devices duit didn't even exist when tile game was 
written. By using tfie InputSpixxrkei Aid, the game writ wx)rk with 
all devk'es that have an InputSprrx’ket driver, present and future. 
Just think — your game ct>uld Ik* die fti^t one played with the 
Direct Neurol Implant Conti oiler in tlie year 2001! 

Networking 

Going l>ack to main, I've handled InptitSprocker 
inilkilizatiun. Next up is initkilizing the network axle. 
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Listing 4: NetSpr ockctSupportc _ 

IniiNctuxirktnj; Snippet 

if (J NetSprocketPresentO) 
return (false ): 

// tnirbli/e NctSprtieket 

stattiEj " NSpInlt ial ITielkStandardHesi^BgeSize, kBufterSize, 
kQKleieerUs. kGaraeTD. kTitneout) : 

FAIL^OSSTATUS(status, "NSpInlttal1xe failed-); 

Unlike Draw'Sprocket and InputSprocket, I don't need 
NetSprocket to be installed in order to play ific game, [f die user 
does' have NetSprcxker, I enable the game to be played over ttie 
network. If the user doesn't have it, I simply dLsable the menu 
item that allows the user to play over the neiwork. They can still 
play with one or two players on a single macliine. Wien linking 
the game, I im[K>n NctSprcKkctLib as a "weak’ link. Doing this 
alk>ws die game to am even if NetSprocket isn't present. The 
key is to make sure that ycjii do not try to call any of die library's 
functions if not present at rundme. I do this in Sprocketlnvaders 
l>y checking if die NSpInitiallze function is valid (nonmull) and 
setting the gNetSprcKketPresent global flag accordingly. 

Once I have determined that NetSprocket is present, 1 
initialize it by calling NSpInitialize. 1‘he values you pass to 
NSpInitialize help NetSprocket optimize the way it handles your 
messages. You give it ifie 'standard' message size, which in the 
tuse t)f SprcKketlrivaders is the size of the player input message. 
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The next iwu parameters teil NerSprocket how much buffer 
space to pre-allocate. You can set fxjth of these to 0 to have 
NetSprcx-ket use default values. The game ID you pass should 
l>e your applic:arjon’s creator type. NetSprocket uses tliis as a 
unique identifier for your game, allowing it to pick a default 
TCP/IH port number or an AppleTalk NBP type ifiat is unique for 
your game. Tine time-out parameter simply tells NetSprocket 
how long it should wait, in milliseconds, l^efore giving up on 
certain network oj>eradons, such as making a connection. 


Drawing 

main y few more initiaJi?4t(rtns, iht'ri calls Graphics I nit: 


LisClug 5: Graphic's.c _ 

CntphkslrUt Snippet 

lniiklb.es our color table, gets our buflcis ready, and fades the screirn. 

USpStartupO : 

// CUJT 8 is the standarel color tabic and is always present 

gGameCLOT = GetCTablofR); 

DctachRefiotJ reo ((Hnod 1 gJ gGameCLUT); 

// l^eRne and create our drawing coniexi 
Gt dpities ii GleetContext (vodi fiorsl; 

// Add our yiriou.s ctJiors to the cnh>r table 

GraphicsHergeCLUT(123, kFirfltlconColar. kLastlconColQr): 

GraphicsHergeCLUT(kFTCTGasCloud, kFirstBGColor, 
kLflRtBCfColor) I 

Graph!csMorgeCLUTtkCLUTSprites, kFlrstSpritGColor. 
kLaistSprlteGolor) ■ 

// Create our underlay and load a picitirc into it 
CraphiesCreateUnderlayf}: 

GraphlcsLoadBackgroundtkriCTGasClcmd}t 

// Swap the bulTm once to get the underlay image on the screen 
nSpContcxi._CtitBackBuiter(gDispLayContext, 
kOSpBufferKind^Horrufll, ibackBuffer): 

0SpConte3Ct_In valB^ckBuf f erkec t (gD i spl ay Con Lest L» 
&backBuffer*>portilecr J; 

CtaphiceUpdateScreenC); 

// Fade up from hlark and then put tlu: context in the paused state 
// so that Ihc user has access to ihc menu bar 
nSpConiexi_l?'adeGaiiinaIn(iiil, nil); 

Gruphic^FuusedO ; 


A ('olor lookup table, or GLUT, is simply a lablc of colors 
ihai the vicit^o hardware uses when in 8-bit video mode. 
Technically, a GLUT is a Mac:OS resource that descrilies a palette. 
Sinc'c one cannot express a C[)mplcie range of colors with only 8 
l>iis, t tjmpuicrs use indexed colors that simi?ly create a palette of 
colors, mucli like a painters palette, that the computer uses to 
dmw everything. When using indexed colors, every pixel on the 
screen must be one of the colors in the paleiie. More 
sopliisticated games use custom color tables designed to make 
the art in the game IcM^k very c<k>1. !f a game has no need to 
draw' anything in yellow, for instance, yellow s spot in the 
palette can (x: used for another color — perhaps anodier sliadc 
of pinky-russet. An even more sophistic:ated use of CLUTs is to 
animate the color table, rapidly changing tlie contents of each 
entry in die table. This technique is used in Marathon and many 
other high-end games to f^rcxluce stunning lighting effeas. 


However, Sprocket Invaders really doesn’t need to lx: that 
sopliisticated. In fact, if it weren’t for the nt^at l:>ackgrQund image 
used, I probably ccxild Iiave gotten aw-ay with using the standard 
system palene. 1 wanted everything to ltK>k just righi tlwHigh, so I 
took tliice difTcTeni Cli ITs — h.ir the lxickclrt>p, tlx? icoas, and die 
sprites, and meiged diem all into one CIDT that DrawSprcKket 
uses for the front buffer (the one dial Ls actually displayed on ihe 
screen.) Once Tve created the ciistoin GLUT, 1 load in the 
backdrop PICT as an underlay, which is simply a buffer that 
contains the image that should l>e drawn under everything else. 

The astute reader might note that I have glossed over tlie 
GraphicsSelectContext function. TlTe reason is that the ctxle is 
pretty^ self-explanatory. DrawSpnx^ket c|tiilc handily allows you to 
specify exactly what kind of video environment you want your 
game to run in. If the user lias a multi-sync monitor that uses 32- 
bit color in 1024x768 resolution, but your g;ime w’ants to run in a 
640x480 screen with 8-bit color, DrawSj>rockei can set the 
monitor up exactly as you want it, then ,sei it Ixick to exactly tlie 
way it w'as l>eforc the user ran your j^ime. ft nviy not sound like 
much work, and it's not hard for you to do using I>rawSpaK:ket, 
but 1 can tell you thai using DrawSpnxket to set your video 
mcxle saves you, the game developer, fwnwmiLs headaches. 

Once DSpRndBestContext returns a Driw^SprfK‘keT context Can 
oliject fn)m which I get the front and Ixick bulTcrs), I get the back 
buffer and invalidate it. Finally, 1 call DSpContext_SwapSuffers, 
causing DrawSprockei u> move iIk' Irack buffer tt.> the front. Since 
the back buffer is invalid and I have set an underlay buffer, 
DrawSpr<x:ket c:opies tlie contents of the underlay to tlie front 
buffer leaving a .screen that conlains thc^ nice hickdrop. 

I should note that 1 also use DniwSprcK'ket's gamma fade 
routines to fade out the screen IxTore \ do the [niKJe switcli (to 
640x180x8), dien fade back in. Gamma fades are a very nice way 
to hide the ugliness of swiicliing moniior m<xk^ from the user. 1 
highly recommend that ytm folk>w ihe s;inie prtxedure when 
initializing your game. 

Sound 

Hie last service to initialize Ls sound. Hie sound initkilizaiion 
requires that I allocate new sound dumnefs using the Sound 
Manager^ as well as create new SoiindS[>ia)ckel ohjccts, if 
ScjundSprtx'ket is installed. 

Good sounds are a [iiusi for any game because they 
dnimatically improve the enjoyabiliiy. For the amount of work 
done in toding, the payoff is huge. 1 u.sc* the Sound Manager in 
SprcKketlnvadcrs for all of my sen intis. As with mo.st games, 1 
allocate a set of sound channels that I use for all the sounds 
played in ihe game. I decided to use the .same number of 
clBnnels as I liad stjunds, assigning each to a cItanneL If a sound 
is already playing in tlie clianncl when 1 ,sian a new sound, the 
new sfxmd simply preempts the old one. 

This approach wtxks just fine for Sprcx^ketlnvaders, or for any 
game with a limited numlxa- of sounds. Htwever, if your game uses 
lots of sounds, yai shcxild consider anodier approach to allocaling 
.stxind dtannels, such as selecting an appiopriiite channel based on 
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Ixw iiTHTortJint ii Is for lire user to liciir die sountl 

Once 1 liave iriilialized the StHiotl M;ma^>trr iteius, I iniliali/.c 
SouiidSprcxrket, iP it Ls present at nmiimc. 


LJstin}; 6; SouiidHaiidler.c 

Iniltalizrs (tir Smiml then iTcaitii UJt tKcessafv 

jpJJl Miuitd 


Sinm4iri:iiidkrln(l Snippet 
SiJundSprTHrIlin ribjm-ls tcj do 


// Crcaic dii* Metier 

theErr - SSpUatener_New(6!giJj3t<rnnr); 
if trh^ErrJ 

Fatfl 1 Error ('’Could not create a sound sprockot 

n 3 t e ne r *; 


// Define 4j«r unit of distant e mi*!i*iurfmeni 

tbeErr - SSpUsterier_SeLHoU?rKFf^rlInlt(^Listener, 0,0S) i 
if (theErr) 

FatfllError ("Could not bol rt^fernnrp dtfitnnr.e for 
lintenet. "*): 

// Attach tbf MiuruJ IcK^jfizatkm cirniponcni to caeb of ilic jjjund 

// chatinchi that we ll be playing through. 

tor (1 “ D: i C BotuidNumSoundfi: IM) 

( 

SoundCoaponentLink nyLlnkj 
// Create the MHiJvc 

iheRrr - SSpSource Nev(SigSpurceLlJ 3: 
if (LheErr) 

FatalKrtor("Could not create a sound sprocket 
source,"3; 

// In.'italJ the filler 

iiiyLlnk. description. cowpontfiitTy pe = kSoimdKf fectsType l 
myTJ nk,descEiptlon,coraponentSirbType ^ 
kSSpTiOcal ir.at ionSubtype: 
niyLliik.deaerlpI lon^coiBponentManufaGtOter = 0; 
myLlnk.tleifCrlpt I on. component Flags - 0: 
uyLink.dBScripliott.componentFlag.sMask “ 0: 
uyLink.mixerlD “ nili 
mvLink.lltiklH = uli^ 

rhcKrr ^ StidSetInfo(gChanneis[ll» 

fi \ PreKlxerSoundComponent. AmyLink) r 
if (thcF.rrj 

FatalEtrorC^Coirld not install ihe sound sprocket filler 
into the ehuiinol ."3 1 


fiSoiindSprocket * true: 
SorI.isrenerLoemtioB(3: 


All 1 neetl to do is alltK’ate a new ItsUrner ot>jeei (so iliai 1 11 
know the relative locations of the sound generators), set the 
distance units (wtiicli are pretty arbitrary), and iUTmcIi a 
kK’ali/ation com|xment to each sound channel The localmitioii 
coniptinent is a filter plated into the Sound Manager that allows 
me to specify c<Jortlinales when 1 play the sound The filltrr 
t:ikt.‘s liiose etxjrdinates and attenuates the ,st>ijnd at:cordingly. 
Well, f said it wasn't easy. Inttializaiton is liard w'ork. [ 
skipped some of the details in each aa-a, and 1 didn’t fully explain 
,some of the services used — I will do that later. Renieinber, 
tliouglu once you liave initializetl one game, you aie well on your 
way to initiaii7lng many (alters. 


Step Five — The Infinite Loop 

I ain referring to the Game Loop. GameLoop (in 
Sprocketlnvaders.c) is called by the appliauion shell’s main event 
](xj() (after it Uikes aire of liie business of handling MatOS evenis). 


litis step is actually quite involved. It cm lx.’ broken down into 
stages, each of wiik'h will at|iiia' a g(Mxl deal of explaining, 

• Handle player input, 

• 1)0 collision detCLiion, 

• I kindle game logic, 

• Dnivv i.wcryihing, 

I'lic event looji is a very important pan of llic game 
k’cause it Ls the hearltefi that keeps the game alive. In addition 
to tlie stages listed alK)ve, there are some other sundry tasks the 
game kx^p routine takes care of — things like cheeking to see if 
llie current wave of the gime is over nv the user wants to quit, 
Tiiose pieces of code are siraightfojward MucDS programming, 
let’s l(K>k in iiKtre detail at the stages listed alx)ve. 


Handle player input 

In lire earlier incarnations of live game I had an input 
impleiuenuilbn that used GetKeys, It ux>k me under an hour Co 
add InputSprocket support. Now, Stirocketinvaders can be 
playetl with jiisi aJxHil every coneeivahle input device available. 

HtiW to handle input depenils on whether or n<x tlie game 
is being played over the network. Wiien playing locally w^ith 
either one or two players, I simply call GetGreenInput and 
GetRedlnput. In a one^player game, the player is alw^ays the 
green player. In a two-player game, player two is the red player. 

Wlien playing ovct the network, I need a little bit of extra 
logic. The player who hosted the game (advertised it on the 
network for another to pm) is always considered player one, 
the green player, I1ie pc'rsoii who joined the game is player 
two, the red player. Therefore, when I do my input, the host 
player (glAmHost is true) first reads the Green input from the 
local computer then sends it uj the other player. The player 
who joined reads the Red input from the kx'al compuiLT and 
then sends it. Each titen calls the GetF/ayednput function for the 
other player. Hie input for lhal other [>layer will liave come in 
via the netw'ofk by die liiix- the GetP/aj/e/Input function returns. 


Listing 7t SprocketInvaders.e 

tk!t tlx inpui fnmi Ixiili pluvLTs. 

If (eNi^TPlay) 

t 

It (i^J AniHortl) 

I 

GetGreenlnpul 0 i 

Send 1 nputStaictgGatneKeyfl.grecnLeft, 
gGaroeKeys, groenF i m); 
GetRedlnput0 : 

1 

D(* 


(imiiirLoop Snipptt 


gGameKeyfi.gretiiRight . 


I 

GetKi'ri IrifuM (): 

SendltipulSlati'tEGaueXeys.redLeft, gCameKeyiJ. rcdlltgbt i 
gCuvcKoyg. rr'dFi ; 

GetGreeninpiiLt): 

» 

1 

LOlIf 

I 

GeiGreonTnputO: 
if (gTwom^lyl^rs) 

CetRedlnpuLt): 
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For now, Fll gloss over how liic input is delivered via the 
network. Just take it as during net play calling tlic Get P/aye/1 nput 
function for die remoLc player will get the necessary input over 
the network. I do, liowcvcr, want ui look more closely at what 
happens when gening the input for die local player. 

I use lnputSp[ix;kei for gening the player's input because it is 
by far the most reliable, expressive, and aimpatible input API that 
exisLs for the MacOS, Reliable because it has been extensively 
tested and, unlike other methods such as GetKeys, you 11 never 
miss an input event. Expressive because you can tel! 
InputSprticket your game's wildest needs. Need three analog axes, 
twtj huUons, and a toggle switch to play your game? No problem. 
InputSprockcl maps your game's needs to the player's input 
devices. Compatible because you know iPs going to work with 
most input devices available, including the keyboanl and mouse, 
Thrustinastcr PCS, WCmS, and RCS (try playing Sprocketinvaders 
with the mdders — it's wild!), all CH prtxluas, Gravis Game Pad, 
Gravis Firebird, etc, Ihc list keeps growing. 

Enough extolling of virtues. Let's look at the code for 
getting infonnation from InpuLSpnxrket. 

listings; Sprocket!nvaders-c _ 

CictCrmilnput Sai|>pct 

Obtains the Input stite for the tocal player fitim lnputSpnx:ket. 

UliU32 input: 

// Cheek ilw movement axis 

I SpElement^Cet S \ rnpl pS La i e {glnputElements [ greenMovement ] , 
feinpLit); 

gCa moKey s . greetiLe ft = 
gGami^Keys.geeenRight * false: 

if (input < 03£2FFFFFFF} 

I 

gGameKeys.greenLeft = true: 

I 

else if (input > OaBFFFFFFF) 

( 

gGameXeys.greenRifeht * true: 

1 

else if (input < t]x'>FFFFFFF) 
i 

ftGreenAccun *= ((float] Input - (float) OxSFFFFFFF) / 

(float) 3FFFFFFF: 

If (gGreenAccuiii < 1) 

E 

gGaueKeys.greenLeft true: 
gGreenAccum +“ 1: 

I 

J 

else if {input > 0x9FFFFFFF) 

( 

gGreenAccun ((float) input * (float) 0x9FFFFFFF) f 
(float)0x3FFFFFFF: 
iC (gGreenAccum ) 1) 

I 

gCameKeys.greervRight “ true; 
gCreenAccuiB J; 

1 

I 

// Cheek the fire button 
gGameKeys.greenFire - 

GetAutoFireButtonlglnputElementfilgrcenFirej): 

'I'he game specifies wliat its '‘needs" are at initialization 
time — for Sprocketinvaders, a lefl/right axis and a fire button. 
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During the initialization, 1 expressed those needs to 
InpurSprocket. Now, as 1 check the input for the player, 1 get 
the left/right movement information in the form of an unsigned 
value beiween 0 and OxFFFFFFFE 0 means the axis is all the 
way left. OxFFFFFFFF means it is all the way right. The game 
has no idea how Inpu(Sprocket Ls gening this information from 
the user, and frankly, it doesn't care. All it knows is that 
InputSprocket and the user have agreed on how the user 
indicates left, right, and Fire. 

The first line of this funaion requests itie axis information 
from InputSprockei. Remember that this information could be 
coming from a true analog axis, such as a pystick, or it could be 
cf>mtng from a digtnl source, such as die keyboard In either case, 
you will gel bac:k an aruilog %^lue. Because 1 would like U> allow 
people with joysticks lo finc.s.se their movements, I do a little extra 
work than necessary to deal with a true analog device being 
inovcxl only a portion of the distance between ifie center and the 
extreme limit For instance, if the value I get back is between 
0x2FFFFFFF and 0x5FFFFFFF (lowards the left, but not quite all 
tile way), then 1 use a global to accumubte leli movement until 1 
reiich a tlireshold, at which point die player input for iliat iteration 
througli the game lLX)p Ixx'omes '‘move left." 

listing 9: SprocketlJivaders.c___ 

(itiAuii)Firelkmon Snippet 

Iktemiinc's wbetber the user is Iryinp lo firc. 

// |x>ll 

error * ISpElement GetSirapleSiaieCinKleinent, input}: 
if {! error (Input ” klSpButtonlkjwn)) 

fire = true: 

// but don't miss fast Oicks i>r macros do 
I 

ISpElementEvent event: 

error = ISpElewent. GetMextEvent (i nEU'BiGnt, 

siiieof (ISpEl moni Event ], &event * fiiwasEvent); 

if {! error wasrEveni && {event.data == klSpButtonDown)) 

I 

fire ’• true: 

break: 

I 

1 while EwasEvent lerror): 

// tlusb iltc qutm* 

ISpElentent.Flu^htlnElement}; 

1 fere I get the ciirreni .state of the fire button (up or down), 
but I also check the InpulSproeket event queue to see if there 
wa.s a burton down event. I check die event tjueue in case the 
y.ser hit die fire Ixiiton really quickly and dien released. Checking 
die curreni state of die lire button wouki not tell me that this had 
happened, but getting die input cvenLs from InputSprocket will. 
Tills Is a gixxl example of how using InputSpnxrket i.s superior to 
other mediods, such as using GetKeys. 

Why do I check tlie liutlon slate and get the input events? The 
answer Ls simple. I want the user to Ix^ able to “auio-fiie,” so that 
holding down die fia^ bution will cause the next shot to lx fired as 
soon as the current one is done. 'While there are other ways to 
handle auto-fire, such as keeping the button .slate in a globa! 
varialilct I felt dial this implementation was the easiest metfuxl. 
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Do collision detection 

The game maintains several lists, including players, 
enemies, and shots. Each time through the tcx>p,! need it> cheek 
to see if any of the enemies' shots liave lat tlte players or any of 
ilte players’ si lots have hit the enemies. There are many subtle 
ways of doing collision detection. Nearly all of them c:ome down 
to comparing one rectangle to another and determining if tliere 
is any overlap The more sophisticated methods reduce the 
nunilxT of comparisons done, Sprocketlnvaders uses the brute 
force approach, which is just line For its need.s. 

listing 10: Sprocketlnvaders.c_ 

tjoUicltShoi3n’oEnt:iiik^ Snippet 

l^erform^ all enllisinn detection for the pUyei^' ?ihot^ and the invaden>. 

GameGbJeetPlr shot: 

CattieUbjectPtr target; 

if (! gEnemyLiet) 

retutn: 

// Iteraic over the giecn player shots 
1£ £ gGr oen P1 aye rShotLi st) 

I 

for {shot = gGreenPlayerSbotlisr: shot: fsbot = ahot“>next) 

I 

// iterate over the enemies 

for (target “ gEneroyLiSt: target: target = target >nexL) 

! 

Rec t u; 

H Union of sh(ir and enemy screen reels 

SectRect{&shot->screenRect» &LargGL >scrcenRecT, hu); 

if {! EniptyRect (£iu)) 

I 

SoundHandlerPlay (soundEneinyHit ♦ target - >sc reenX. 

T.arg<»t->scrs€nY): 

NboL >octlon ^ flayerSboTDestroy; 

target->aetioti Enotiyllesiroy: 

AddPoints(target'>screenX, target >screenY); 

1 

I 

I 

J 

For every .shot die green [dayer has cTcated, I check each 
enemy in the enemy list to see if the shot's rectangle rwerlaps 
with the enemy's rectangle. If I determine there is an overlap, 1 
set the shot's action proc to lx PI aye rShotDe stray, and then set 
the hapless enemy’s aaion prer to be EnemyDestroy, Utter in the 
game loop, 1 wall execute these Functions. I also play a sound 
effect and call Add Points, wliieh c’auscs the little “KX)’' sprite to 
appear. When ilicre are two players, the CollideShotsToEnemies 
function repeats the same process for the red player’s shtHs, 
After the game knip doe,s collision detection for the players' 
shots, it checks the invaders' sliots, using a similar process. 

The part about setting the ob^cts' artion pnxrs may sumnd 
confusing, but it really isn't. f:^ii h olijai in the gatne, as pan of iLs 
(lata structure, includes a function pointer that, wlien non-null, is 
executed in the game logic phase of the game kK>p. It is an 
approach to dealing with the game aaioas that is ol>ject-c>riented 
hut does not rexjuire Also, you might wonder why 1 have a 
shot list for each player, when each player can have only one shot 
at a lime in the air. Ihe reason is that 1 wrote the game to be 


extensible and flexible. In the design phase, I decided not to 
allow more liian one shot. However, should I have changed my 
mind later on in the development process, it would have been 
trivial to change the game to allow more shots. By ccxling it in at 
the beginning, I remained flexible in the impIementaUon. 
Flexihiliiy is an extremely important part of game design and 
implementation, especiaQy when radical changes (such -ds adding 
network support) c’ome along. 

Handle game logic 

Let's Face it. Invaders are dense. Tliey move left and right 
in a compleLely predictable pattern and speed. As their numbers 
are reduced by the player’s skill at shooting fish in a barrel, they 
get madder and madder, and thus move faster and slKK)t more 
often. They don't actually target the player. They don’t follow 
the player at all. They are dumb. 

Nonetheless, you need to have logic in your game, if the 
computer controls any eniiiies in it. Even the simple task of 
making tlie Invaders behave in their single-minded manner took 
quite a bit of work. It is not as trivial as one would think. 

Consider the way alieas speed up as llieir numbers decrease 
and the wave number increases. Of course, there are several 
IXDtentml ways of speeding up the aiJeas. You could as.sign each 
alien a velocity at the beginning of the wave and increase it as 
their numlx;r.s decrease. However, you might note that the aliens 
not only move faster and Faster, but also shcx>t more often. You'd 
liave to process all the aliens fastt^r and faster as llie game went 
by, perliaps requiring you to check the TickCount all the time. 
Clearly, tliis approach lias a gcxxl deal of complexity. 

I believe the solution 1 used is more elegant. To l>e honest, 
! was inspired by the way die original Space Invaders handled 
this problem. I set a global variable, gEnemyGas, that is 
increased at the beginning of each w'ave, but remains constant 
during the entire wave. This value is the total number of aliens 
processed each time through the game bop. For example, 
gEnemyGas is set to 2 for wave one. If you l<K)k closely, you 
will see that the aliens seem to move in pairs. Thai is because 1 
prcxiess two of them each time through the game loop. 

Tills may not seem very interesting until you consider what 
happens as you destroy the little liuggers. At the tiegiiming of 
the level, there are 5 rows of 11 aliens, totaling 55 invaders. 
Since I process only two of them each time througli tlic loop, it 
takes 28 iterations through the game Itxip to move the entire 
.swarm one step to tile right (or left). During those 28 iterations, 
you are free to move around and shoot at your leisure. Put in 
more technical terms, your input is proemsed 28 times for each 
time any single invader's action proc is executed. 

Now consider what happeas as their numbers are reduced. 
If you destroy half of the invaders, you arc left wiili 28 aliens. 
Since 2 alien.s per iteration arc processed, it now' takes only 14 
iLeraiions of the game loop for a given alien to be prcxzessed 
twice. Relative to the number of times your input is processed, 
they are moving and firing more often. As the waves advance, 
and the value of gEnemyGas increases, the enemies will move 
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anil fire faster and faster. In fad, there CDines a lime in each 
wave wlien ilicre Ls more gjis than there are alieas. When that 
happens, the aliens liavc the upper hand, because they get 
processt‘d multiple times for every time your input is liandled. 
Evenutally, tfie aliens will win, Kesisrance may lx* flitile, but it 
can lx* alot of fun! 

Let’s l(X>k more clusely at ex;iitly how to ‘'pnxess” a single 
invader. During the initialization phase of each wave, I ca*ate 
and initialize each enemy invader. One part of that j^rocess is 
assigning the enemy's action prex: to lie Enemy Action. Until an 
external event occurs, siich as lieing hit by the player's missile, 
this action proc is execiiied eacli time the alien is processed. 


listing 11 : ObfectActions-c 

IHfincs ibc ilcknili Ixliavtor uf 4ii ctieniy. 

If (theObfect OrefCon > gEnpiiByLpvt??) 
r etu rti: 

rliRGbjfvcT )fefCon++: 

gNiiinKneui I esP rorosj3t!d++; 

if (tli^0bj«ci->r€fCon & i) 
theUbject >tT4nie - U 
else 

theObjeet->frflrtie = 0; 

// Dcftifniiint if thi^i <*114 my In shixil 

If (Gas[i?‘_Hunduin ({2 ‘ kKinnKnemies ] gKu[QEnemie&} ’— 1) 
KnemyShoot (LlieObject): 

// Ad (ii!ii iioictn poNilioii Jc|x,iKliiig on wilt" I her we 're muviiig Itfi or rigbi 

if (gEueisyTask = kEnpmyHovIngRI ghl) 

I 

theObJert->nrreetiX T- gKru'niyVeloelly: 
elou if CgHueTiiyTask ^ kEneniyKovingLeft) 

the0bject->screera( - gEoeaiyVelffeify; 

I 

el^e if (gEnemyTafik “ kF.m'«y|Irop|inig) 

I 

tlieObjerT >tit toeuY +“ kKriemyVrUrup: 


EnemyActiun Snippet 


// C.hefk fur Iximuii Imuiid 

it (theObject >screenV > theObjert >boundR.burTuiii) 

I 

gNuaRedPlayerLivciT = 0: 
l^NumGreenPlayeiTJ veil = f)j 
retiiro; 

I 

// {3ieek lefi Ixiiiiidb 

if {theObject-^screenX ^ theObject >lK)UodjFf.left hh 
(gEnenyTask ^ EnguiyMovingLeft.)) 

gEuGiiiieaChsngeDt reet I Oil " kKfu'inyHuvijigRight: 
ret urn; 

I 

// (Tieek rigid Ixiujicb 

it (the0bj€ct‘>screenX > theObject >boun(jn.righr fiA 
(gEnemylask EneniyHovinp.Ri^ht)) 

r 


gFnenienChangrDiree L ton 
retur u; 


kbnemyHovingLeft: 


1 set life refcon Ibr I he* ohjcxi so the enemy sprite Is animated 
as it moves. If die refcon is even, one version of the sprite Ls drawn. 
If odd, anoilier Ls u.sed. (The lefcon Ls also ased to lielj) deLemiine 
wliere in the enemy nlijed list I left off When prexessing the aliens,) 
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1 then incTcmcni ilic gNumEnemiesProcessed varisible st) that Til 
know when I run out of "gas” for this iteration Uiougli llie loop. 
Next. 1 ranclomly tleekle if tJds [lartiailar invader should fim, I mt)ve 
the unit left, righl, or down, check to make sure it hasn't readied 
Lite Ixatoni of tlie saeen (in which (.:ase the game ends), and rmally 
check to see tf the aliens nml to cliarigc direction. Note that once 
one enemy detxles to cliangc direction, all the others Ibllow^ .suit 

That's it. Not extremely sophisticated, yet tricky enough 
dial it mkes time and effort m do ii right. 

Draw everything 

By this time, 1 have gathered all the input, performed all 
the logic, and done all of the collision detection. Now I want to 
draw everything so the user can see it. 

AO of the objects in Sprocket Invaders arc stored in lists. Look 
back at the code for Game Loop, you see that I call 
GameObjectUstDraw for all lists nuintained, Nae that 1 pass backBuff 
as tlie .seeond parameter to GameObjectListOmw. Tills background 
buffer Ls cTeaied during the iniiialLsition of DiawSpiocket. 

Anyone who has tried doing any computer animal ton is 
likely to Ise faniihar with the tene known as “tearing” — when 
objects moving on the screen have their top halves drawn in 
one location and iheir Ixitconi halves drawn In another. Ttiis 
effect takes place because the game is changing the contents of 
the video buffer while the computer Is busy reading the video 
frame buffer and drawing it on the screen. 

One of the 1x51 ways to avoitl this ugly effeti is to do all of 
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your drawing into a bac:l< l)ijffen in main memory or in VltAM, 
then copy the entire i>ack buffer into the frame buffer ihat is 
being drawn to the screen. An even more sophisycaled methcxl 
does this process while “syncing to VBL”, which means thit the 
copy is done only when tile monitor’s scan line ha.s reached the 
bottom-right comer of the screen, and the monitor is re,setting it 
to the top-left comer. 'Ihese methods have liccn around for years 
and there are many articles and Ixioks that destribe how to do 
them on MacOS computers. However, with the advent of 
DrawSprocket, all of the ugly details of doing double-buffered 
graphics are hidden frian you, and you are left with an extremely 
easy API allowing you to get all the benefirs of double-buffered, 
VBL-synced graphics without any of the annoying mess. 

listing 12 ! GamcObjecLc _ 

GaiwcObjcclUsttlraw Snipptrl 
thrciugh thf given object IIhc, dm wing e^di object. 

for (index = list; indojo Index = index*)noxt) 

I 

lnd&!t’>ficreenfieet = SpriteToGWorld{iT(dfiK->f;prlte* 

index->fraise, dest. index->5creonX, index*>screenY}; 

GraphiCKSetReetDirty(AindeX'>screenRect): 

index )oldScreenRect "=* indeX’^screetiRect: 

I 

GameObjectLfstDraw calls SpriteToGWorld to copy the sprite 
image into the back buffer. It then calls GraphicsSetRectDirty to 
tell DrawSprtJckci tliat, when it is time to copy rlie back buffer 
to die front buffer, this partt<'ular area needs to be refreshed. 
This is an extremely important step to ensure optimal 
performance. Wlien you specify the “dirty'” (changed) areas of 
your back buffer to DrawSprctekei, it copies the conients of 
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only those areas to the rrt)nt [)uffer. If you move only one or 
two sprites, copying only the areas tliai tiave changed is lar 
more efficient than copying the contents of the entire hack 
buffer 10 the front l>ufrer. 

You might note that I am not calling DrawSprot:ket directly 
from wittiin this routine. I1ie reason Ls that I wanted to make 
the code as portal)le as possible. This is 3 good example of 
what 1 mean when I say you should implement your code in a 
flexif)le manner. By abstracting out the blitting of the sprite to 
the back irnffer and the function for setting the diily rectangles, 
you allow yourself the option of easily removing DrawSprocket 
and putting in another drawing library. This might be necessary 
if I wanted U> port the game to Windows, where I wouldn't 
have DrawSprocket available. 

After I've copied all of the sprites inU] tire I Jack buffer, it Is 
time to finally move the image to the screen so that the user 
sees it. DrawSprcxkcl has made this task extremely easy. Here 
is the entire code for GraphicsUpdateScreen, the last function 
called in GameLoop, 

Listing 13: Graphics,c__ 

(iniphk‘st|pitaicScT(xn Snippet 

(kxlc that gets c:vt:rythin];> iiispla)t!d on the moititor. 

DSpContPXI: Sw^pBnf ferstgOiiaplayContext. nil. nil); 


This function copies the dirty areas of the hack bulTcrs into 
the front (dis[j!ay) buffer. Not only that, but it also syncs this 
(Xjpy to tile next VliL to eliminate tearing. DrawSprocker uses 
on-the-fly crxle generaiion to gain optimal jK-rformance for your 
copies. Without DrjwSprtM'keC, you woukl have to do a large 
amount of work to get the same performance and features you 
get out of this .single call. 

SiTiF Six — Networking 

Network supp<irt was the last feature added to the game. I 
didn't plan on making SprtKketlnvaders a networked game, l>ut 
NetSprocket makes it so easy to add networking that I couldn't 
resist. If I had wanted hare-bones NetSpnx-kei support, I could 
have had it with much less code than 1 ended up with in 
NetSprocketSupport.c. I da:ided it would be cool to have a chat 
window l>efbre the game actually begins. In retrospect, this may 
not liavc Iieen the Ix^st design decision, since $prockcilnvaders 
is limited to two players and there really isn't much to chat 
alxjut. However, yt)u should slill l)e able ro ust‘ the chat-related 
code in yrnir game, 

I already discussed initializing NetSprtK'ket in step four. 
What I want to cover here are three other areas — hosting, 
joining, and playing. 'Ihere are some otiier jxirLs of handling the 
networking, .sue h as what to do when tlie game ends, tliat I will 
gloss over. Once you understand the ctxie tbr the three areas 
li.sted, you should understand llie rest. 

With NeLSprcx'kei, hasting a game on a network Is a pkx:e of 
cake. To host a game, you neetl to do two things. First, you need 
to present a dialog Ix)X tliat aHow.s tlic user to specify die game's 
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name on the network and the network protocoKs) to use. Since 
NetSprocket hides the whole issue of transpon protocol from 
you, it also pre^senrs a t:oiiriguration interface to Lite user. 


I.].sting 14: NetSprocketSupportx _ 

DoHosmarne Snippet 

Hosts a g^me on the network so tliat others may join. 

status “ KSpProt:ocolList_Kew{NULL, ifiitheList); 

// Do the host diilog 
O.tChooserNaifie fplaycrMaae): 

CopyPStr (kNetvorkCajnoKnftR, ganeNaine); 
passwordfOl “ 0: 

OKlllt ^ MflpDoModalHostDislogithfiList, garasNamt^, playerNatne^ 
pansword , t^ULL}; 
if {lOKUlO 

return t£alsv}; 

if Now hosUUe gamt- 

status = NSpGame^tlusL CligT^otGame, theList, kMaxPlayers, 

gaiiiaName, password, playarName, 0* ktJSpClicntServer♦ 0); 

£|'A1L_0S STATUS (status. *N!jpGaiBO_Host returned an error*’): 

RSpProtocoiLUt_Dlspose(theList| : 

When the NSpDoModalHostDialog returns, it tells you 
whether or not the user hit OK. If so, you need to call the 
NeiSprocket functittn Umi actuuliy creates all die necessary 
endpoints, etc:., so Lliat others may join your game. Information 
gathered from the user in the dialog box is passed along to tlie 


NSpGame_Host function'using an tjpaque protocol list. You don’t 
need to know anything about tlie protocol lists or die protocol 
refs, except that you need to create an empty list to pass to 
NSpDoModalHostDialog and then to !MSpGame_Hosl. For more 
inftirmalion about the parameters to die two hexst funaions, see 
the NetSprocket dcx:uTnentation available on die Web. 

After 1 successfully host the game on the network, the 
DoHostGame function calls WaitForAllPlayers. 1 won't get into 
tliis function here, since it really doesn't make up an integral 
pan of the game. Feel free to take a look at the code and 
borrow wlialeveryou want. 

Joining a game on the nem^ork i.s even easier than hasting 
ihe game. 

Listing 15: NetSprw:kelSu|>portx __ 

DtjJviutiauiu Stiippei 

Joins a game being hosted on the network, 

CetChooserN^EneCname); 
pasEwortl[0! * 0; 

glAmHost = false: 

thpAddress - KSpDoModal JoltiDialog(kNSl’Type. kJoinDialogLubel, 
name, password. NULL): 
if (ihF.Addreas WULL) 

// IItc user cam elled 
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return (falfiti): 


Etatun " NSpGume.jQin(^gHetCamp* theAddress, name, pasEWord, 

0. MULL. 0, 0); 

FAlL_0SSTATUS(statue I “MSpGaine_Join returned an error"); 

A^ain, I call a Netsprcjcket HI function so it tan enal)lc the 
user [o choose a network protocol and select a game to join. I 
a.ssume That tlie host and the joiner will somehow agree on 
what networking protocol lltcy are going to use. 

Rather tlian a protocol list, tlie NSpDoModalJoinDialog 
returns an opaque address ref chat is passecJ lo NSp6ame_Join. 
The reason is that you can join only one particular game at a 
time, while NcLSprocket allows you lo host a game on nioliiple 
networks at tJie same time, it is entirely pcjssible for you to Ix' 
playing a IVetSprcKket game that has some people u,sing TCH/IP 
and others using Applelalk, Of course, that is not possible in 
Sprcxrketlnvaders, since it limits the numlxT of players to two. 

The last thing 1 want to discuss about the nei working is 
how to handle senciing and receiving messages. Recall tliai 1 gel 
the remote player's input from the network. Let's lcx>k at the 
code that actually dixs thau 

Listing 16: NctSpnicketSupportc 

Handle Net working Snippet 

CriTl.'i ;il| netwofii mcis4iaj;cs from Uie other player 

theMessage NSpMegsage.Get {gNe^lGuiHe); 

If (thoMeEuage 1“^ NULL) 
f 

l)0UHndleHeE&agt5(theMt?iji?age); 

^ NSpKeaaaga Release(gNetGatne. theWeEsage); 

DoHandleMessage is just a big dispamher rhat handles 
difTerent kinds of messages ihal f miglit get. including player input, 
chat message, game over, etc. Since i am interested in input 
messjiges, I will kxjk ai the ccxie tliat deaLs witli an input numtge. 


intended recipients, and it al.so contains the information 
necessary for the recipient to detcrniine what kind of message it 
is. When I want to send a new message, such as a Icxzal input, I 
fill in the mess;ige structure. 

Listing 18; NetSprocketSnpport.c_ 

ScndlnpuiSlaic Snippet 

Sends our inpui stMe to rhe remote player. 

PlayerlnputMoaaagG thsKesEage; 

QSStatUfi siaiuar 

NSpClcarHessageHeadGr (iithoMossagtf.h): 
ihGMesEage.h.to = kNSpAlIPlayers: 

IheMessage.h.what ” klnputMessage: 
theNessage-h.inGfisageLeii = siaeof (PlayerTripuiMessage); 
theMGsEagG.left - left; 
theMesfiage.rlghi = right; 
theWeEsage.fire = fire; 

status = NSpKesEage_Send(gNetGanie, &theMessage.h, 
kNSpSendFlag^Registered): 

Here I create a message tliat is addressed to all players. 
Conveniently, this means “the other player” in a two player 
game, since messages sent to everyone are by default not 
delivered to the sender. I fill in what kind of message it is so 
the recipient will know how to interpret ii, and how big it Ls so 
dial NetSprcx'ket will know how to deliver it. With the header 
information completed, all that remains is to fill in the aenial 
mes.sage information, which I obtain from the globals (which 
were, in turn, filled in by the GetP/ayertnputState). 1 then tell 
NeUSprocket to send it, and I am done. 

Without NetSprocket, adding network support for 
Sprocketlnvaders woiiki be a daunting ia.sk, requiring a large 
amount of work and lestlng. I probably would have had to 
choose lietween using AppleTalk or TCIVIP, and probably 
would not have Nithered with a chat s< reen. To lie honest, it 
probably would not have Ixien worth the elfort. 


Listing 17: Ncl.Spr{KketSiipport.c 

DoHandJcl^aycdnpm Snippet 

RnKtvic?; ihc pUyer inpui itussage fnim ihc remote player. 

if (gTAmllcisL) 

I 

gCa me Keys, re die ft ” I nNcasage->left; 
gGameKeys .redRight ^ i.iiMessage->rlght; 
gCameKeys.redFire ' iriMeEsage-)fife; 

else 

gGampKeys.greenLeft = lnMeesage->left; 
gGameKeys.greenRight 1nMGb'Eage->right; 
gGameKeys.greenFlre ' InMessage-Xflre; 

gKeceivedInput true: 

Definitely ntu rocket science. I just fill in the remote 
player's keyboard stale and hit a flag to lei the game loop know 
iliiit IVe received the oUier player's input, 

I liave defined a NeLSpnxkei message structure for player 
input mes.sages. Like all NetSprocket messages, the player input 
message has the NSpMessageHeader structure as its first Held, 
This header is what NetSprtxket uses to deliver messages to the 
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Step Seven — StiiiND 

I made the effort to use Sound Sprt>cket to localize the 
st>unds in SprfX'ketlnvaders, just to show how easy it is to do. By 
localizing, I mean that 1 attenuate the s{)und“s volume and 
left/right balance based on the position of the .sf)und-geaerating 
ot)jeci relative to the listener. You am write titc localization cede 
yourself, bul why botlier when StJundSprcx'kei can do it for you.? 

la^rlier in tJiis article 1 talked alxjut initializing SoimdSpiocket. 
All I really did was alkxate sound channels, iastall filters in the 
diaimels, and set tlie listener location (effectively, the player's 
location) to be the Ixatom middle of die ,scTeen. As 1 play die 
sounds, ril specify die kx^ition of the sound gene rating objects 
(sucli as an invader firing a missile) in the same ccxirdiriale system 
as die listener, so titai the fitters alter the .sounds as if the human 
player w'ere inside die ^me. 

Every time I warn to play a sound, I call the 
Sound HandlerPlay fiinction. 
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Usting 19: Souiidllandlenc _ _ 

Sound] [andlcrPUy Snippet 

a siiiiiid, doing JiK.aLizaiHm lm»t if SuundSpmeltet is jnhUlkd, 
if (gSotindSpfOck<»r) 

f 

TQBCanteraPlacemunt lof^ation; 

SSpLocflli^ationDatfl localisation: 

// POsiiicMi the sound In space, 'iTie lower left comer nf ihr screen il (0,0) 
locuLlnn .catieraLocation^x " 640 x; 

location.camnrat^ocation.y 480 y: 

locatiori.eoiiit*ral^cation,z * 0i 

// Orictii the sound st> rluir it is d<iwn directed dtjwn towards tlic listener 
location.pointOfInterest.K " 320; 
locatiQn.pointOfInteresL.y 0: 
locat Ion.poititOfInterest.X - 0: 

iocation.upVecr.or.x ^ 0; 
location.upVeetor.y = 0; 
location.upVector.z = -1; 

theBtr SSpSoUrce^SeLCaJueraPlacement (gSource tthoSound j. 
^location)r 

if ItJieKrr) 

Fatal Error (““Failed to set the fioiirce location*): 
theErr ^ SSpSnurce.CalcLocalizaLion (gSourceftheSoundJ* 
gBintener. ilocalization): 

if (theErr) 

FataiEtror ("Foiled to calculate the localIsiar Eon*}; 

//Wt don't ikj cloppkr, since wc only l<x:alj?c the scjuml 4i iJic in.staiit it is played. 

1ocalization.cutrentLocation.sourceVeloclty “■ 0: 
localizarIon.currentLocation.11GtcnerVelocity “ 0; 

// Wc set the rcfetcncc distance to a rca.sonablc iiurabtT that seems to gel good 
// results 

// We also provkic a minimiim dLstJiiu:c tjf else wc run into rcaJfy IXll really 
//CUPPED stiunds 

localization.referenceDlsianco "= 20.0: 

If (1realization.currentLoeaI ion.distance < 5.0) 
locoHzaxion.curretitLacatlon.dUtance ™ 5.0: 

theErr = ErtdScitTnfo (gChannelsltheSoundJ , 

siSSpLocalization, Alocalization): 

if CtheKtr) 

FatalError("Failed to localize the channel*); 


// Play The sdecicd H)und immediately 
theEri = SndPlay(gChannelsttheSound]. (SndLlstHandle) 
gSouivds[rhe.^autidl . true); 

if (theErr) 

FataiEtror("Failed to start sound in SndPiay()."): 

If SDyndS()rocket is installed, use the position information 
of the objeci in the game to create a tocarion that 
SoLindSprockei can undcrsiand. I also need to cTcaic a fx>mt of 
interest, because SoundSprocket allows you to liave an object 
project a sound in a certain direction (think of the difference in 
sound of a penwin yelling depending on whether dial i>erson is 
facing you or facing away from you.) SoundSprocket calculates 
the necessary localization information tliat I then pass into the 
sound channel, which in turn passes the information to the 
sound filter installed at initialisation time. 

That completed, I actually play the sound by calling SndPlay. 
If SoundSprocket is not installed, all of the steps above are 
skipped, and the sound is just played — always at a single 
loiidness, always with equal stereo balance. I l>elieve you can hear 
and api^reciiile the differenc'c in effm if you run SprcK^ketlnvaders 
with SoundSprcx'ket installed, tlien run it without. 
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S j LP Eight — Enjoy 

Over liic course of this article, I iiave gone through ail of the 
mapr steps necessary to take an idea for a game and rum it into 
reality. I hit all of the major areas that once would liavc presented 
serious, possibly insurmountable, challenges for a would-l^ game 
developer. I have shown how liic Apple Game Sprockets make it 
much esEsier for you to implement the most diffitiili asfX'cLs of your 
game — input, higli-speed blitting, and networking — and to add 
ax)l features you might never have cToasidered like 3D sound. 

I presented SprockeLInvaders in a very structured manner, 
but obviou.sly things dorVt always happen iliat way in real life. 
Do not lx- dLsc’Ouraged if things don't Impixm in quite the same 
structured way when yim sit down to write your game. 
Different aspects take different amounts of effort for different 
people. Here is an estimate of how long tt cook to utilize the 
various Game Sproc^kets. 

• InputSprcxket — under an hour 

• SoimdSprockci — about an hour. 

• DrawSprockec — ahoui four hours. 

• NetSprcxket — two liours for the basit^ sopport, another day 
for the chat dialog. 

The Sprocketlnvaders .source code has some other little 
programming jewels that I didn’t even mention. For instance, there 
is source to play ‘‘Red Book’’ audio from CDs and a set of 
debugging memory management funaioas. It c'an be a faniostic 
resource for your next giune. 

I know there arc many cool MacOS games waiting to l>e 
written or sitting half-written in archived disks. 1 hope that what 
you've learned here will enable you to dust off those archives 
or sit down and start working on your game, comfortable with 
the knowledge that you 11 be free to work on the game itself, 
railier llian on the tedious infrastructure necessary to implement 
it. I hope yours is the next insanely great, totally addictive, 
totally ctx)l game for the Mac. 

Credi'i Where rr’s DtiE 

Ihis article would not exist if it weren't for the sample code 
Sprtxkctlnvaders, written by Chris De Salvo, with coniril^uiions 
from Cary Farrier, Michael Evans, Tim Carrol, and myself. 

lhanks to reviewers Kathy Osborne, Cliris De Salvo, Cary 
Farrier, and Brent Schorsch. 

No llamas were injured in the aeation of thi.s anidc. B 


Want to suggest an article for the 
magazine? Send your suggestion to 
<mailto:editorial@mactech.com> 
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COMMUNICATIONS 

TOOLBOX 


By Mark Chally, Covina, California 



HappyFace 


Using the Communications 
Toolbox to build an 
interactive, t wo-player game 


The purpose of ihLs article is to 
ixnplcjnent a simpie, two-player, interactive 
game as a means to explore Apple's 
Macintosh Communications Toolbox. It 
includes methods for using tlic Connection 
Manager to .send and receive infomialion. 
This article builds on the fundamentals 
learned in the DebugTcrm article, found in 
MacTcch 12J0 (October, 1996). 

Introduction to Hapf\ Face 

where did tl come from? 

After DebugTcrm went to press, I 
suggested a follow-up artkle to further 
exploit the CTB. I thought a simple game 
would Ixr entertaining and Instrudive. Time 
was short, hut die challenge was exciting. 
Of several fxtssibie game ideas, HappyFace 
was the clear choice, having the advantages 
of simplicity and entertainment value. 

Long Ix^fore Barney tile dinosaur would 
be loadied by adults eveiywliere, diere were 
liappy faces. Surely you remember tile little 
yellow [lill-sliapetl guys witli K(X)i-Aid grias, 
found cm T-sliias, pi as, and bumper .stickers 
aaompanied by “Have a Nice Day.” Soon, T- 
shirLs displayed happy faces witli bullet boles 


in their foreheads from which blood oo^ed. Later, arcade games 
appeared in which players would use mallets to strike gophers' 
heads as they poked up diroogli hcjles. Finally, Mike Darweesh 
wrote the Mac:intosh game “Bonk,'' liased on the gopher games. In 
Bonk, pbyers click on silly heads as they apix^ar in a grid, liefone 
they disappear — at progressively shorter IntervaLs. I lappyFace was 
inspired liy that weial combination of satosm and gaming. 


How do you play it? 

HappyFace is a two-player game that gives you the 
opportunity to smack those little yellow critters, Ychj ase the CIB 
to connect with your oppcinent. HappyFace does not care what 
tool is used to establish the connection, but it does expect the 
tool to support a means to siniuitaneoiisiy send and receive data 
using the standard CTB functions. Most, if not all connection 
t(K>ls do this. You earn ixunis l>y striking the faces as they appear 
on a grid. ITie first player liaving 25 points w'ins. 

Wlicn launc:hed, if HappyFace canntJt find the preferences 
file in the program\s folder it poses the Connection Settings 
dialog (Figure 1). 
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Figure L Conneclion Settings Dialog with 
Apple Modem Tool's ik^dult optiotis. 


Though chiefly compensated for InformaTion Systems work, Mark Chally lias derived much of hi.s satisfaction from 
developing programming tools, utilities, and games — such as HexFIags DA, Flipper FKEY, ShowScreenSi/e FKFY, PatliKey, 
DensePrint and Telekinetic Chess. Visit his web page ai <lmp://homc.eajthIink.net/-'chally> or send your ideas and 
comments to <chally#eari}iJink,net> or P.O, Box 2295, Covina, CA 91722. 
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If the user cancels the dialog, the program beeps and 
aborts. Otherwise, it creates a game window with 64 squares, 
eight rows and eight columns. HappyFace then waits for the 
user to establish a connection, which is initiated using the 
Connect, Listen, and Jjetlings items on the Comiection menu, 
Onc:e a c:onnection has been established, either player may 
select New Game from the File menu. When the game begins, 
each player's copy creates five happy faces which inhabit 
randoinly .selected squares in b<.idi players' windows (Figure 2), 



Figure 2. We Hal>f^Face JiHndow untb no faces stmek. 

Eacli player may then strike liappy faces l)y clicking on 
them using the cursor — which becomes a niailet whenever it is 
positioned over the window. As the faces are struck, their 
features (eyes and mouths) change color and shape. Faces 
which have not been struck have blue features. Those struck by 
the player using the local copy receive green features, and those 
struck by the opponent receive red ones (Figure 3)^ 



Figure J, 7he HappyFace window 
wilh faces struck by kMb players. 

One second after each face has been struck it dies and 
vanishes. Tlie copy of HappyFace wliich created the face (the 
local copy or the opponent’s) replaces it with a new one that 


inhabits another randomly selecLed square. The first player to 
strike 25 faces wins, at which time a dialog is displayed by each 
copy to inform the users of the good or bad news. When no 
game is in progres.s there Is no mallet, and any faces remaining 
do not respond to being clicked. At any time during the 
connection a new^ game can be started, including while one is 
in progress. If a user quits while connected, the connection ts 
closed. If a conneaion is closed, any game in pn^gress ends. 

CTB Rfcap and Comparison to DebugTerm 

What is DebugTerm, and why read about it? 

In the Debugl’erm article, I implemented a C source file that 
could lx; compiled into a program under development in export 
debugging information through a CTb connection. It made a 
good introductory project because it required minimal CTD 
services. If you have not read it, T strongly suggest that you do 
since it provides an inmxluction to the CTI^ and some Irase code 
for HappyFace. In short, this article builds on tfmt one. 

Where did DebiigTerm fall shart? 

DebugTerm is a good start, but not a complete program. 
Serving as a debugging tool, it takes shortcuts in opening and 
cltjsing a connection lltal a uscr-fricndly program should not. 
Secondly, it only sends information, it does not know how to 
receive it. Additionally, it only initiates a connection using 
CMOpenQ to connect with another device or program; it dtx^s 
not know how to use CMListen(). Finally, it asks the connection 
tool not to use windows or menus, thus requiring no event 
processing. HappyFace addresses these new issues. 

Making a Complete Application 
Isolating connection logic 

HappyFace loehaves as a CTB program should. It initializes 
the C\l^ and creates and configures a connection record iii launch 
lime. However, CMOpanO Is not executed until the user wishes to 
open a connection. In contrast, DebugTenn executes CMOpen() 
Immediately after creating and configuring the connection record. 
DebugTerm also disposers t>f the conneeLiem record at the .same 
time that it closes tlie conitcction. HappyFace waits until quitting 
time to dispose of the connection record, at which time it also 
saves the configuration. For thi.s reason, the pRx:e.ss of opening 
and closing connections is simple and reliable. 

It pays to CMU^ten 

Besides isolating the initialization from opening and tlic 
disposal from closing, HappyFace also adds a new and important 
way to connect; CMlJ$ten{). Some tools require one party to use 
CMUslenO while waiting for the oilier to initiate Lite connection 
using CMOpen(). For example, in resj>unse to CMUsten(), the Apple 
Mcxlem Tool waits for a telephone call from another modem. Tine 
AppleTalk ADS? T(k> 1 rcgi,slen> iiself on tlic network and wails for 
a connection request from an ADSP Tool using CMOpen(>. 
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Both expect the iipplk:'dtic>n to respond to CMOpen(} by acicepting 
iJic connection using CMAccept(). Tlie Serial Tool does not suppoft 
CMListen{), It uses CMOpenO to est^tblish a connection through the 
serial port you choose, lliiltke most tools, it does not care alx)ut 
wlielher anytliing is at tlie otlicr end of tlie .serial cable. HappyFace 
does another important thing that DebugTenn did not do — it 
polls the connection for incoming messages iLsing CMReaci(). 

Handling the interface 

In addition to those details, HappyFace also accepts a new 
realm of responsibilities. T1 rrmintarns a Connection menu that 
allows the user to decide when and how to choose and 
configure a tool and establish a connection. This means that 
HappyFace has the duty of maintaining these menus, in 
addition to the events, most of which it passes along to the 
conneaion tool via CMEvent(), CMActivateO and CMResume(). 
dhese events may also be generated for additional windows or 
menus lliaL HappyFace permiLs the tool to create and maintain. 
Certain events can be identified as belonging to the tool and 
passed along. HappyFace deteas and delegates these, 

Encapsulating CIB code 

Virtually all of these activities, which relate solely to 
maintaining a CTB connection, are contained within CTB.c. 
HappyFace, merely an example of a CTB application, can lake 
advantage of this by installing a few MENUS, passing along 
important events, and making a few simple function calls, the 
ease with which CTB.c can be used is appareni since CT9.h 
profiles only a few simple function calls. 

Encoding a game mes!»age 

Tiiere are three game actic>ns requiring messages: .start a 
new game, create a face, and stiike a face. Communication logic 
is simplified by stuffing an eniire message into a .single byte c^f 
the form AAHHHVVV. 

The ilrsi two bits represent the game aaion, the next three 
represent the horizonuil position if applicable, and the last three 
represent the vertical position if a[)plieable. Some bitwise 
manipulation is required when sending and receiving the 
message, but ilte utility of treating a single incc^ming charaaer 
as an entire message greatly simplifies tilings. 

Tes'I' Spin 

Before exploring the workings of HappyFace, let's watch 
the game in aaion. There are many ways to connect using the 
Ci'B, but you should consider the following points that you may 
find remarkably similar to those of the DehugTerm article. 

Means of Connection 

If you have an AppleTalk network or intend to demo 
HappyFace on a single Mac, I recommend that you connect 
using the AppleTalk ADSP Tool. Otherwise, I recommend the 
Serial Took if you choose the Apple Modem ibol you can 
connect by modem, bul probably will not have the opportunity 


to see both copies of HappyFace side by-.side. You may choose 
to use anolher tool, in which case 1 am interested in hearing 
about your experiences. 

Using the Serial Tool you can connect two Macs, or even 
connect a Mac's modem port to the same Mac’s printer pt>rt. To 
use the Serial I'ool, you will require a null modem cable. 'Fhis 
is the cable used for most printers and to communicate with a 
Newton by serial port. It is up to you to get the connection 
right, but if it works between terminal programs, it should 
work for HappyFace. 

If you choose the AppleTalk ADSP T(K)I, you can connect 
between two Macs on a network, or from one Mac to itself. To 
connect a Mac to itself with the AppleTalk ADSP Tool no 
physical amneclion is necessary, hut he sure AppleTalk is 
turned on in the Chcx).ser or Uic tool will not load. If you need 
a copy of the AppleTalk ADSP Tool, you can find it on one of 
Apple's FfP sites. You may also find what you need on FTQ or 
the CTB SDK. HappyFac:e needs the Communic:alioas Too11k)x, 
32-bit QuickDraw with at least a Ifx’olor monitor setting, and 
the Sound Manager. It would I>e a gtXKl idea to use System 75 
or later since HappyFace does not use Gestalt to check these. 

Connecting to Yourself 

If you c:hoose to connea the Macintosh to ilself, either by 
LLsing the AppleTalk ADSP Tool for a viniial hookup, or Serial 
Tcx>l from modem to printer port, you should keep one tiling in 
mind, To connect a Macintosh to itself, you must use 
asynchnmous calls. See the diairii>es in tlie DeiiugTenn artic:le 
about asynchronous calls and completion routines. HappyPace 
also ha.s an “efnpty" completion n>utine. To allcjw a connectiem 
between two copies on the sajne machine, 1 compiled 
HappyFace u.sing asynchronous calLs. Thougli many readers 
without two Macs may wisli Co take advantage of thi.s feature* 
you will find HappyFace awkward to play ns a two-player giime 
when both copies are on the same machine. Al.so, tlic 
HappyFace I compiled is a fat binary so that it will am native 
on PowerPC machines. 

Bang Away! 

You will need to use two instances of Mapi^yFace. Ideally, 
lhe.se instam:es would be nm on separate machines. However, 
if you want to run i>oth copies on the same machine, simply 
make an additional copy in another foldenuK] launch each 
separately. Preferences are .stored in the application’s folder. If 
you have already run HappyFace, you may wish to throw away 
the file named T tappyFace Prefs.” 

!.;iunch one copy of HappyFace. If it hncLs no preferences 
file, it poses the Conneaion Settings Dialog ix.Tore allowing you 
to do anything else. If not, select Settings... from die 
Connection menu. In the dialog, use the Method popup to 
choose the connection tool you wi.sli, such a.s tlie Serial Tool or 
the AppleTalk ADSP Tool (Figure 4). 
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4 Connection Saltings Dialog 
with the AppleTalk ADSP TooVs optiom. 


If you diasc ihc AppleTalk ADS? Tool, y<)u may duxj?ic a 
name for the machine by typing what you wish into the Local 
Name; flekl in die lower-right-hand aimer It is probibly best not 
to change liie Connection Type field, Iml if you do, lx>Ui insUinces 
of FlappyFace must have the same type, Press the OK button. 

If you chose the Serial Tool, you can select the port 
settings that you require. The ones displayed are probably the 
best (Figure 5). ‘ 



Fi^«re 5* Connection Settings Dialog 
with the Serial TooTs options. 


Regardless of how you set them, they should all lx: set the 
same for botli copies of HappyFace, and the Current Port 
should be set to whichever port your cable is plugged into, 
Press the OK button. 

If you diose die ApjdeTaJk ADSP Text!, duxxsc dx: Usten itaii 
from the Connection menu. You C’an tell tot 1 lappyPace is listening 
tor a connection bec::iiise the Usten item now rends Stop Ustening, 
and tile uJier items on dte Connection menu are dimmed, 

Lf you chose the Serial Tool, choose die Connect item from 
the Connection menu. You c:an tell that you are connecied (to 
the serial cable) liecause the DLsamned item is now enabled 
and die other items on the Connection menu are dimmed. 

Now you are ready to connea die second copy of HappyFace 
to the first. Uuinch the .se‘cond copy, [f you chose Uie AppleTalk 
ADSP Tool, choose it again from the second copy. You should see 
the name of the first, listening copy in the scrollable Pst on the 
righi-hand side under the Name field. Yon may need to find the 


AppleTalk Zone chat the first copy is in from the list on the left- 
hand sidej under the Zone field. Select the name of the first copy, 
and press die OK button. 

If you chose the Serial Tool, select the same settings as in 
the first c'opy, except the modem or printer port as necessary. 
Press die OK Ixitton. 

Now select Connect from the Connec'tian menu. The two 
copies of HappyFace should be ready to start a game. You can 
tell they are connected txjcaasc die New Game item on the File 
menu, and the Disconnect item on tlic Conneaion menu are 
now' enabled, and all the other items on die Connection menu 
are dimmed. If you .select New Game from the File menu ten 
hapjiy faces should apjxxir in caclt window. 

Use the cursor (mallet ) to strike faces in each copy. You 
should see stiniething like Figure 3 when faces are being stnick 
from both copies. Notice how die features of a face struck 
locally become green, but those of one struck by an opponent 
turn red. Notice that HappyFace allows one second to pass 
before die face you struck '"dies,” 

Normally the game ends when a player strikes 25 faces. 
Quirting either copy by selecting Quit from the File menu or 
closing the HappyFace window breaks the Connection- 
Selecting Disconnect from the Connection menu also ends any 
game in progress. Continue to play as many games as it rakes to 
get a feel ff>r it. 

SoiiRCF. Code Waik-theough 

HappyFace was written in C, using Merrowerks 
Code Warrior Integrated Development Environment (IDE) 1.7. I 
used two project files — one for 6Hk, and one for PowerPC. If 
you use Symantec, MPW, or some other development system, 
you should not have much troufjle creating projecl files. You will 
either want to print a copy of the .source code or view it on 
your monitor alongside the article. 

Overview 

This project is divided into three separate code domains. 
The file CTB.c isolates the CTB code so that it can be used, 
much as a libraiy would, along witli CTB.h, U should require 
little modification to be included within another project. It 
contain,s private data stmetures and functions specific to the 
operation of the CTB. CTB.h contains useful constants and 
function prototype.s to #include in other source files. Game.c 
contain.s functions and private data .stmeture.s that are specific 
to llie game Icjgic, but have no spccinc knowledge of the CTTT 
Game.h contains prototypes for the Game.c functions that 
Mainx needs to call. Main.c contains the ‘‘boilerplate” code 
necessary to launcli the program, handle simple events, 
maintain the cursor and menus, and quit. 

Header files 

CTB.h is similar to DebugTerm.h. In addition to function 
prototypes, it contains shared resource ID's, and literals for 
parameters and common errt>r codes. 1 sliamelessiy kept the 
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error ccxies from DebugTemi, although 1 could have developed a 
more extensive set. The literals, such as kAsync, help make 
the code readable. Game.h has prototypes to game functions 
that are called by Main.c, 

CTB.c 

This file contains C code necessary for Communications 
Ibolbox connections. You are already familiar with most of it, 
having read about DebugTerm which was extended from 
DebugTerm.c, We now concentrate on new or modified fundjons. 

It begias with a #inctude to CTB.h, then defines its literals 
and globals. One of the “new^^’ features is a group of Universal 
Procedure Pointers (UPP), such as gCMCompletion, for 
PowerPC compatibility. 

CMWriteProcO, formerly CMSendProc(). is unmodified. 
However, ycni sfiouki inspect ii closely since T originally 
irploaded an outdated version of CMSendProc(), whicli I have 
since replaced with a more correct version. 

ConnEventO handles events lor a connection tool window. It 
LS called from tlie event loo[:) to give tlie connection tool tlie first 
opportunity to handle the event. CTB tools poke their own 
handles (e.g, ConnHandle) inU) the refcon fields of their windews. 
Therefore, ConnEvent() finds tiie window asscx:ialed to thnEvant 
Next, it makes sure it has a valid WindowRr and ConnHandle. If 
not, it returns false, else it check.s to see if the winclow's refcon is 
the .same as the ConnHandle. If they are not the s;ime, it retnrn.s 
false, Olhcrwise it returns true, indicating iliai tlie event was 
handled, after calling CMEvent() to delegate the event to the 
(’onnedjon took which handles the event if‘ appiopriate, 

ConnActivateO infijrms a connection tool of an activate 
event. Called from tlie place in tlie event loof) wliere activate 
events are mapped, it passes tlie messiige on to the connection 
tool, indicating whether tlie window is lieing activated or 
deactivated. ConnActivateO ^saves die current GrafPort and sets it 
to the given window before calling CMActivate(), then restores 
ifie current GrafPort. 1 found ihis behavior, taken from sample 
code in imide CIB, odd. I would liave exjK^cted die WindowPtr 
to be passed as a parameter instead. 

ConnResumeO is structurally identical to ConnActivate(}, Ii 
informs the connection tcxil of a resume (or suspend) event. 
The resuming parameter indicates whether the application i.s 
being suspended or resumed. 

putc(), provided fiir .simplicity, calls CMWritePmc() to send 
the character it receives as a parameter. It returns whatever 
value it receives from CMWrtteProc(), 

CMReadProcO attempts to read 'theSize characters by 
calling CMRead{), If gConn is not nil, it returns the value 
obtained by calling CMRead(h if there is no connection record, 
it pas,ses back 0 a.s TheSize. This version of Happy Pace always 
issues CMReadO calls synchronously to make the anicle .sim[)ier. 
Next time, we will need to expand its aipability, CMReadProcO 
is a Pascal function so it ciin be called by the 'I'erminal Manager 
or die File Transfer Manager in a broader implementation. 


getc() tries to read a single character by calling 
CMReadProcO- If it finds none, it places a NULL in c. It returns 
whatever error CMReadProc() encounters. 

InitCTBStuflO, essentially tlie same function as its 
DebugTerm coimterpart, additionally generates UPPs for the 
CMCompletionO, CMWriteProc(), and CMReadProcO by c.:allmg the 
appropriate managers’ functions. 

ChooseConnectionO has been modified to liehave better in a 
modeless program environment. Now kNothingChosenErr is only 
rctunied il' cancel is pressed (so tliat it tun lx: trapped at startup 
when no preferences are found). It still returns noErr if tlie cuircait 
tool is reconfigured or a different tool Ls selected, since we do not 
need to care Ixic^iuse we never allow fiiLs dialcsg to he posed while 
connected. In all otiier aises, it returns w4iatcver CMChoose() dtx-s. 

NewConnC is one of three functions that replaces the 
functionality of DebugTerm’s OpenDebugTerm(). NewConn() 
handles most of its funcLionaliLy, making it almost identical. 
NewConnO does not call WritePrefsO or CMOpen() where 
OpenDebuglermO did. 'I'hese tasks are left to DisposeConnO and 
OpenConnO, respectively. It does a few additional things, 
however It initializes gFlags to false, which, when passed to 
Cl'B functions, (currently, according to Inside CTB) indicates 
that we do not wish to .send end-ofblock indicators. It also 
passes the async parameter through to the global varialile 
gAsyncCalls and sets gPrevStatus to an imjiossible token value, 
which will cause the status to be re-evaluaied in ldteCoTin(). 
Finally, it calls GetMenu() for the handle to the Connection 
menu, which was installed in the main program. If NewConnO 
encounters an error, it returns it, else it returns noErr, 

OpenConnO, called when the Conned item is selected from 
Lhe Conneetkm menu, calls CMOpen() to open a camnection. 
First, however, it verifie.s that the connection record exists. It 
returns whatever value CMOpenQ returns, 

ListenConn{) is called wdien the listen item {or Stop 
Listening) is selected from tlie Connection menu. It fii^t verifies 
that a connection record actually exists, and if so, it calls 
CMStalus{), If CMStatusO indicates that the tool is already 
listening for a connection, it calls CMAbort() to stop listening, 
else it calls CMLfsten(), instructing the tool to wait indefinitely (- 
1) for a connection. Unlike nirrst fiindion.s which can be called 
synchronously or asynchronously, Happy Face calls CMListen{) 
asynchronously rcgardle.s.s of the value of gAsyncCalls. It does 
ihis because some tools, such as the AppleTalk ADSP 'I'ool, 
provide no opportunity to stop ILsiening wfien asked to wail 
indefinitely. Using the asynchronous call allows the user to 
select Stop Listening, which causes ListenConn() to call 
CMAborlQ. Some Ux)Ls, sudi as the Serial Tool, do not supyxm 
CMListenO at all, and return cmNotSupported. If an enor occurs, 
the error is returned, else noErr is returned. 

CloseConnO is one t)f iwo functions that split the duties 
previously perfonned by CloseDebugTerm(), Wlien ilie user selects 
Disconnect from the Ctmnection menu, it first verifies that the 
tx)nnetiion record exists, then verifies that the connection is open 
or ofx:ning. If st), it ctilLs CMCIose() to drop the connection. 
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DisposeConnO i.s the second of the two funclions that split 
CloseDebugTermO's duties. Called before HappyPace exits, it first 
verifies that the connection record exisLs, then calls WritePrefs(). 
Once tile preferences liave been written, it closes the connection 
by calling CloseConnO, unkxhs the connection handle, and calls 
CMDisposeO to deallocate tJie connection record and any other 
data the tcxil ntay be using. Finally, it sees the connection fcmdle 
to nil, and reports noErr. DisposeConn() does not report any error 
unless there is no connection record, because it is only called at 
application exit. In fact, it calls CloseConn() without diecking to 
see if conneaed It could check that first, and it could also report 
any errors returned by CloseConnO or CMDispose(}. 

IdleConnO, called during each iteration of the event lcK)p, 
performs pericxtic tasks necessary to supixm a conneaion tool It 
l^egins by verilying that a connection record exists, and if nor, it 
disables the connection menu items. Otherwise, it begins l>y 
calling CMIdle{}, which gives the c:(mnection tool its 
housekeeping opptirtiinity. Next, it checks the connection status. 
If an error occurs, it returns it, else if the tool has sensed an 
inccjming caD (cmStatusIncomingCallPresent) it calls CMAccept() to 
establisli a connection. If the connection status has changed, it 
updates the Connection menu accordingly, u|xlates the online 
parameter, updates gPrevSlatus and returns any error that 
tx:curred. 

DoConnMenuQ, called by the main aj^]>licaLion‘s DoMenu() 
function when a connection menu item is selected, calls the 
appropriate CTB.c function. U dcx?.snt bother to report or return 
errors, though you may wish to. It lxx:ps in the case of an error, 
except kNothingChosenErr, returned by ChooseConn(). This is 
because kNothingChosenErr results from pressing the Cancel 
button, which Ls fine when resulting from a menu selection. 

Gamex 

This hie contaias functions to ctjntrol the game activity, but 
no code specific lo the CTB. It begins with a few groups of 
literals. Those in the first grrmp denote spacing and graphics 
proportions. Those of the secontl indicate whetlier a square is 
occupied, and if so, what condition the ixcupying face is in. 
Those in the next control the bounds of the game logic. 
Following that are the codes for the possible game action.s, 
Me.ssagcs sent through the connection have these codes in tlie 
first two bits lo indicate that a face kis Ixen made or stnick, or 
that a new game has Ixen started. Being a two-bit code, llie 
possibilities arc 0-3; 0 is skipped to avend confusion w'ith the 
NUtX character. The literals in the last group are resource IDs. 

Next in Game.c Is the struct used to store information for 
a sc|uare. 

lypedef struct t 

short occupant: // kEmpty. kHcatihy, kStruckLoc^Jly, kSiTuckByOpponcia 
long age; // HckCountO at staius chaagt: 

Rect boundsRec L i // Bounding rccungtc for gSquarc 
Boolean mad eLuc ally;// Keep track t>f whether ittade kx^UIy 
) contents; 


The occupant Field contains a square's si at us. The age 
indicates at wliat TickCountO the square\s status last clmngecf We 
want a face to take one second to die, so we have to watch the 
lime. boundsRect holds the local coordinates of the square's 
rectangle. madeLocally indicates whether the local copy or 
opponent's copy created die face. 

In the interest of fairness, we make sure that each copy 
maintains a fixed number of faces. Wlien a face is cTL'ateti, it takes 
a variabie amount of time to transmii die eretiiun message to the 
opponent's copy. Using the convention introduced here, the 
players’ individual copies effectively lake turns. Tlius, each player 
has a "net equal time delay'’ in the sum of die tlilTerences Ixtween 
the times at which faces are created and become visible. 

Next LS a group of globak, kept private to gamex using the 
static keyword. Tliese are some of die most notable globals: 
gPixMapHand is an airay of the pixmaps used to store the cliffcrLmi 
drawn faces so that they can Ik^ copied to the game window, 
gMadeCount is used to represent the iiunilxT of currently-livirig 
faces a copy has created. gLocalStrucKCounl and 
gOpponentStruckCount are used for keeping .score. gSquare Ls die 
anay of sc|uare contents. gStrikeHand and gSndChannelPtr are 
used to play die siriking sound. gPIcRect is a Rect with its top-left 
corner at die origin and the height and witlth of a .square. 

PlayStrikeSoundO, called wlien a fat:e is smick, verifies that 
the handle to the sfxind and pointer to the sound thannel are 
valid, then calls SndPlayQ asynchronou.sly. 

ShowScoresO is called wtien a game ends to display the 
scores U) each user It counts the jx)inLs op first to .see if tlie game 
was aaually played. If faces have lK*en staick, it ecinverts the 
numbers to strings using NumToString(), use,s ParamTextO to 
prtdoad text for the Dialog Manager, then culls Alert(), 

DrawSquareO dniws the approfiriate image in the appropriate 
place on the game window. First it a.ssures that the parameters, h 
and V, are within the valid ratige oF row^s and columas, then it .sets 
the current Graf Port to the game window' after .saving the old 
Graf Port. It calls CopyBits() to copy the contents From the 
appropriate pixel map we alrc^ady created to the appropriate place 
in the window. Finally, it restores the ajm'nl GrafPoft. 

NewGameO, indirtictiy oiled wlien either jilayer seleds New 
from the Kile menu, initializes Ihv game st;uus variables, sets och 
square's contents as empty, aiul draws each sc|uare. 

MakeGWorldO, borrowed from the Dmv Mark ariic:le, calls 
NewGWorldO to allrxrate a fresh default GWoiid to store squares' 
graphics in. 

NewGameWindowO, called at application launcii, initializes 
everything on which the game'.s logic le.sts. It Itegins l>y seeding 
the random number generator with the long integer which 
rejiresenis the ciiircnt date and time. Tlien it attempts to create a 
new sound cliannel anti load the SHD resource for the strike 
sound, which it moves into high memory and Icxks if successful. 
Note that the sound playing code dcjc.s not attempt to play the 
sound if either tsf these could not lie alkxrated. Next, it takiilates 
the size and ixisilion of die window^ calls NnwCWindow(), fills die 
gSquare array with empty' squares, and c^ltiilates rheir rectangles. 


50 


HakhyFacc 


MAdl'ECHM.AOAZJNF. • FkHHI .AHV 1997 












hbr L“jdi the lour ^>raphics iiml to draw .squares, it !(kkIs ihc 
pixel maps ami draws iheui into iheir own separate GWorlds. 
Mt>st of this was also taken from f>atfe Mark, tanally, it calls 
ShowWindow{) to make the new wintlow apf^eiu’ oji the screen. 

KiMStruckFacesO is railed hy ilie tdleGame() funciitm each 
lime through the event loop, It looks ai each square and 
determines if ilie st|uare amtains a face that has heen struck hy 
a player. 11 stc ami if tt was .strin k tuore than one second a^o 
(kDyingTime), it makes ihe .st|uaie empty. a.s.signs the lime of 
vaaincy, redr^iws the square, and if the face was made hy this 
et)py it tlerreiueiUs the numher living faces made by I his 
copy. Ueciiusc* gMadeCkJunt will Ik.* less than kMaxMade, this will 
result in the eveninal creation of a new lace. 

UpdateGameWindowO, ailkxl in resfxjiisc^ to an uixktte event, 
saves ilie current GralPtirl anti sets it to the game svindow. Next it 
finds tile Red liounding Lite update region and n.strs it to decide 
whidi squares are in the regkm. Alter ii has determined what 
ninge of njvvs and a>lLimn.s it ntxxLs kj draw, it calls BeginUpdate() 
to keep from generating addiliomil events, anti draws them to|> 
left to boirom rigiti. It calls EndUpdatnQ lo tuncel BeginUpdateQ 
anti .s(*ts the cutieni GrafPort hack to ihe s^wed one. 

ShowStruckFaceO is c^jilletl when a face has Ix*en struck. It 
receives the horizontal and vertical location of I he face, and 
whether ihe strike was ItK’al t>r hy the opjament. It uses those 
pammclers to update the .st|uare's information and redraw ilie 
square, lielore returning, it [>lays the strike sound. 

SendGameActionO assembles a giime message ajid sends it. 
Tlie mes.sage has three parts, Thv rest of the communication 
logic is greatly simplified hy siufring an entire mes,sage iiuo a 
single byte. Ihe firsi part is a iwobit anion iridicator, the next 
three bits indicate llie horizontal tomprment td the square's 
ItKaiion, and the final three intlicate the vertical component of 
t he .St I LI a re's I (x*:! I it }n. 

First it loads the action indicattir into ilie character, then 
.shifts three liits to the left so ihai it can add in the horiztmtal 
CEimponent. Then il shifts three more bits to tlu‘ left and adds 
the vertical comiionent. Finally, it calls putc(), whose return 
value it also returas, Iti stmd the diaracter, 

SendNewGameO asks SendGameActionQ to send a messttge 
with the kActionNewGame indicator through the coiineclion (the 
Ixirizonlul and vertical compinents tin nf>l matter). 

HandleOpponentStrikeO is called in response to having 
received a mess;ige which indicates that the o|7|X)neni lui-s suaick 
a fact*. First, it increments iht* opptrnem s score. Next, if ilie 
opponent has reached the winning score, it stops the game. 
Then, if the face is aciually healthy, it atlls ShowStruckFaceO to 
change its sialLis and redraw it. Ii abvays gives the opponent 
LTcdit, but does not alw'ays change the square's status. It is 
theoreiiaiUy po.ssib!c for Ixjih filayeis to strike a face “at die &imc 
time'' and for the mess:iges to “cross in the mail.” Instead of using 
a iieriireaker to resolve the c^onlltei, it givc^ Ixnh players credii. It 
dcx.*s not dniw in resixmse to this ca.se, lx*cau.se iluil would oase 
a lace to l hange frtim green to red or retl to grc'en. 


HandleWindowClickO is called when a mouse click in the 
game wandow is detected. First it dclennines which square, if 
any, was clicked, by reducing the Point to local coordinates 
and dividing by the pixel offset between scjuares* As an 
added proiection, it verifies that the calculated value is in 
range, to avoid addressing a non-existent anay member. If die 
row and column are valid and tliere is a healthy face tn die 
indicated .square, it uses SendGameActionO to inform the 
opponent of the successful strike. If no error is returned, it 
increments the player's score and compares it to 
kWinningScore. If the .score has exceeded the winning score, 
the giimt‘ w'ill be stopped. It calls ShowS I ruck Faced to indicate 
to the user that the lace has been struck. 

ShowFaceO puts a tiealdiy face on a given .stjuare. Il seLs the 
square's .status lo indicate a healtfiy face, sets the age to 
TickCount(), and sets madeLocaliy according to the parameter 
that it rcx’eives. Finally, h calls DrawSquareO to draw the face in 
the game window. 

MakeFaceO is called when IdleGameO determines that it 
must place another face on the window to meet its quota, 
kMaxMade. First ii randomly chooses a row and column, 
repc*afedly, until an empty square is found. Next it informs the 
opponent’s copy that it has created the face, and calls 
ShowFaceO to show the user. Finally, it increments 
gMadaCounl, the number of currently-fiving faces that have 
been made by the k)cal copy. 

HandleGameAction0 dispatches game actions wliicli have 
been received to the a]5proprtate function, according to the 
action type,'. In some cases it .start.s or stops a game. Iherefore, it 
pas.ses Ixick the rt^ulling value of inProgress. 

GetGameActionO is called by tdleGame{) each time through 
the even! loot). determines w^hethcr a game message is 
waiting, and if so, dispatches it First it calls getc() lo read the 
character. If the charatlcr is not NULL and there is no error 
reading, il prcKrc.sscs it. It extracts the action indicator by 
totaling a copy of the byte 6 bits to the right. Next it rotates 
another copy three bils to the right and looks at tlie least- 
significant ihfix? biis, which l>ecome the liorizontal component, 
'llie Iciist-signihcant tiiree bits of the original become the vertk:al 
component. Finally, it delegates the interpretation of the 
jiiessageto HandleGameAction(). 

IdleGameO called once from each iteration of the 
event loop, U first call.H GetGameAction() to dispatch any 
o[)ponerit actions waiting. Next it calls KillStruckFaces() to 
remove any faces struck more than one second before. If the 
game is still in progress and the nunilier of faces is le.ss tlian 
llie quota, it calls MakeFaceO. 

Main.e 

Activities not specific lo communications or game logic 
are conducted writlun this file. That leaves calling the 
procedures necessary for initializing the program, 
dispatching events, and tiuilling. Since most of us have seen 
this repeatedly, w'c will brush over ihc !>ulk of the code, 
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discussing only the unusiuil or confusing parts of this file. 

It Ixrgins by defining literals and usual glofxils. Simitr globals 
of note are gHammerHand. which points to the mallet cursor- 
gGameInProgress, which indicates whethcT a game is being 
played; and gOnline, which inditutes that a c'onnecLion is open. 

ExitNowO is used as an emergency exit, while DoQyit() is 
called when a user t:hcK>ses Quit from the File menu. BotJi aiil 
DisposeConnO, which makes sure the connection is closed if 
possible. DoQuitO also shows ihe scores if a game w-as in 
progress, lx*cause there will be no chance tor the event kx>p u> 
deteci that llie game endeti. 


With the exception of MBAR, MENU, PICT, 
SND and ALRT IDs the application source 
code is oblivious to the resource file’s 
contents — not that I recommend ripping 
out DITL resources or doing anything 
else that would confuse the resource 
manager or the Finder. 


InitAppO, in addiiion to calling SetupMenus(), also does a 
lew other things. It allocates the hammer cursor's slriKlure, 
moves it in to high menioiy. anil kx^ks it. li calls NewConn() lo 
install a conneciion record, and if ii fails, beeps and quits, ll 
calls NewGameWindowO lo create the game window and 
initialize supixirting game logic, ilien ftnally initializes Marn.c's 
t>wn glt>bal,s. gOnline and gGameInProgress. 

DoMenuO handles menu ,Helections in the usual way, with 
some exceptions. Since Ikippyhace adjusts ihe cursor, it 
provides an arrow cursor before putting up the Alxiui box. It 
sets gGameInProgress lo true when a new game is siaried. 
Nolice ihai it calls DoConnMenu() to delegate a sc I eel ion from 
the Cxinneciion menu. Ii doc‘s this becm.se it knows tlie iiH’nu s 
ID. Hiere may be a less ;ipplication-specific way to sense and 
iiandle Connection menu seleclions. Perhaps ConnEvent{) could 
sniff them out instead. 

AdjustCursorO wa,s one of the more pesky detail.s of tliis 
project. Called from various places in die event loop, it 
changes the cursor, if appropriate. According to some Apple 
dtH.'umentation, yon can .set it up .so ihar it only gets called 
when ilu* mouse travels ontside a given region, which is how 
Ha[>pyFace was written. You may nolice that ii gels ctilled in a 
couple other places to work around various imerface problems 
apparently not anticipated when MultiFiniler was developed, I 
recommend maintaining the cursor at every opportunity from 
the event toop^ which is wliai later Apple documentation 
seems to suggest. 'Yhis seems to spread less code around 


without effeedng perfonnance. 

MainO calls the iniiializaiion functioas and mns the event 
loop. It uses gameWasIn Progress to detect when 
gGamelnProgress changes, and mouseRgn to pass to 
WaitNextEvent(). It calls AdjustCursor() if a game starts or stops, 
tecause we do not wan! to show the mallet if a game is not in 
progress. When a game ends, it t'ails ShowScoresO- 

Next, it calls ldleConn() to give rime to the connection tool. 
If it finds that the connection has l>een severed, it stops any 
game in progress, l>et:ause a game cannot I>e played with no 
conneciion. It calls ldleGame{), regardless of whether a game is 
currendy in progress, to allow Game,c to handle its own details, 
including removing dead laces. 

Vor each event returned by WaitNextEvent(), it first gives 
ConnEventO an opportunity to handle it by passing it to the 
connection l(X)l if appropriate. If ConnEvent() cannot handle tire 
event, ldleConn() continues its aiiempl to despatch the event. 
Any activate event is delegared to Conn Act i vale (). If an update 
event is for a window other tlian the game window, ii i.s 
ignored, otherwise it is pas.sed to UpdateGameWindow(). A 
keypre.s.s means nothing to Ihif'ipyl^'ace unless it is a c'ommand’ 
key comhination, which is passed to DoMenuO. 

The mouse event.s are handled in the usual way. 
HandleWindowClickO Ls called for any click in the game 
window's content region, if a game is in progress. This 
responcLs in the user striking a face. Suspend and resume 
events arc trapped and passed to the conneciion tool 
rhrongh ConnResume(). 

llappyFace.rsrc 

Happy Face jsrc featiire.s the usual ca.si of cliaracrers. Star 
roles are filled, such us ihe ALRT and DITL resourc:es used by 
ShowScoresO, the PICT resources ustxl to draw happy faces, 
and the used hath hy CTB.c and Main.c. Supporting 

c hanicters arc such as the SND re.source that plays when a face 
is strut k, SIGN resaurevs I bat sftice up CTB nwmis, and the 
CURS resource used io .show the luimmer when faces can ix’ 
struck. Atmosphere is provided by still other resources that 
provide icons and bundle-oriented information, version 
infonnaiion, and the al'K>ut Ixix props. 

With the exceplion of MBAR, MENU, PICT, SND and ALRT 
IDs the application .source code is oblivious to I lie resource 
files eon tents — not that I recommend ripping out DITL 
resources or doing anything else lhal wtmid confuse the 
re.source manager i>r the Finder. 

Conclusion 

What have we learned? 

In this article, we explored a complete apftlicalion using 
Apple's Communications Tttolhox, We created a simple, yet 
entertaining game to exploit key feat tires of the Connection 
Manager, building on a previous article, we have learned to 
listen for a connection, poll for data, and handle interface- 
related concerns such as building and maintaining a 
connection inenii and delegating the appropriate events to the 
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connect km cool. We found time moat of tine msks of 
malntiiinin^ a connection can be hidden frenn die niain 
program. We scratched the surface of c rcating an interactive 
game, though elements of a serious, error checking 
applicatirrn have lx:en otiiiiicd. 

Where do we go from here? 

llte next step Is to develof> a Ibniial pixrttx’ol. Sudi a proux’ol 
woLiki cieteci iransitiission errors such as messages that do not 
reath their destinations, arrive incomplete, or arrive gitrblecl Such 
;in Lindertitkiiig will 1.^ the sul>ii:x:i of the next article. 

If you have comm crus or questions regarding this arlide, 
lee I free to send tliem! 
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TOOLBOX 

TECHIUIQUES 


By Chris Stasny 



The Language of Resources 


A cmmum sense introduction 
to the Resource Manager 

Say Again? 

I discovered y new vcriit>n of English 
when T worked the oil fields of Trinidad 
years ago, l^ait of this dialect’s uniqueness 
was due to the influence of multiple 
cultures on the island — noiahle for its 
heavy and complex accent. Eventually, I 
le;irned how' to res(x>rul to things like, “And 
me anudder spanner. lX\rs one’s t(X> slight.” 
(He wanted a larger wrtmch,) 

Some years later t discovered tliai the 
Macintosh contained its own rendition of 
English, where common tenils w-ere linketl 
in new ways to tVirm pfjwerful commands. 
This is clearly demons! rauxl in Uestiurce 
Manager calk Terms like USERESRLE and 
SETRESATTRS nirn tjul to he everything 
expected and mcjre. This article will focus 
on some common rcstjurce handling 
operatioas. WTiile our syntax will Ix' iliat of 
FutureBASIC Ih the toolbox calls are so 
easily recx)gni7iible that [)rt)grammers of ail 
linguistic persuasions .should he able to 
follow along without dilflculiy. 

Resource Fii£.s 

We all know that our application's 
resource fork Is ofKm and uvailahle. Sc^me 
of iLs understand diat tlie System's rt^source 
file Ls also open and available. In real life, 
there are usually between twenty and a 
hundred resource files open at any given 


moment, on any given Mac*, Kememlier all of those font (lie's and 
.sf)und files that you dumixxl into the System Ef)lder? 

Tlie layers of resources aR‘ gitkled slritlly by the order they 
weiv oiKnexI via ammands like OPENRESFILE or OPENRFPERM, 
If’ you tliink of ytxtr Mac :ls an oil drum, the System file is Qirown 
into the Ixirrel first and always reside's at the txxiom. It Ls Iblkm^ed 
by a pidhora of exteiisioas and additions that come online during 
startufi. We erinnu t hangt' this ortlcr. When we i>|X'n a resource 
file, it is always dirown on to]i. iTIieie some excef^lioas. Most 
notably, (TIB tools am loadetl l)C'low the System msource^, -ed.l 

ApPLK'ATHIN IIhaps 

When an appliattion is douljle-t:licked into life, a divider is 
used to sc'gment the barrel in such a way that the applitTition's 
resources are isolated from tho.se of other programs. Tins 
divider does not extend all the way to the Ixjuom of the drum, 
where .system resources remain fmoled an<l avaikibic for all to 
use'. I'his me^ans that resource files ojxaied ly that application 
can l(K)k down upon lioih appik'ation and system resources 
without ever being aware of items (owned by other 
a(}f)lications) on the other side of the divider. 1’his segment of 
the liairel is known as the application heap. 

rhe search pattern here ts important. If we ask the 
Kesource Manager for :i chunk of bits, it will respond by 
scarcliing the top levels of information in our apfdiealioTrs 
quadrant of the l>arrel. E;ich failure forces it to submerge deeper 
i nit it he timm until it eventually finds itself sermning the System 
resources at the botrom. It is nrjt ptjssihle lt> change this order. 
At l)est, we can lell the Kesource Manager to start at a deeper 
level and ignore some of the sludge ilia I has floated to ihe top. 
We do this with CALL USERESFILE(resRef), 

After USERESFILE, vve have efieetively chofifKd off tlie lo[> 
ptiriion of the barrel, and items ofx'ned after the target file 
beexiine invisible* to the system. Tit is procedure, wBen 
improjX'rly used, often sends a program into a death spiral Our 


Cbri& Afasiij rjlic S'fAZ) presides over STAZdtau with help from hLs STAZ.sisTanf. tk‘ turns complex programming Issues 
oveT to the STAZicil Engineer and delegates nil mix r crunching duties to the S'EAZiician. And let's not forget the legioas of 
STAZlettes that <,>il tlie ever-grinding gears of the STAZomatic. 'lliis machine ha,s lumed otit sucli titles as HuiureHAStC JI, 
ErogniiTi Generator, llie Menu Mill and (TLLssnxim l^ubJislier. 
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firHi mistake is to assume iliai Lite call somehow changes the 
ortler of rcsoiiree files. Tliis is imjx>ssible. Our second mistake 
is to assume that we can put things right by calling 
USERESFILE with the application’s resource reference number, 
llils is alsr) a fantasy. Mere Ls tile only safe way to switc^h forks 
in mid si ream: 

origReS - FN CURRKSFn-K 
CALL USERKStlLK(tesRcf) 

■ Handk- yunr filc-speciTic fcsourcc opemtions here. 

CALL IJSEHESFlLEtorigResJ 

Rules to Load By 

Let’s backtrack for a momeni in rc-exaiiiine the operations 
involved in opening a resource tile. During this operation, the 
ltesourc:c Manager Itxids a m;ip into memory that lists all of llie 
bkjcks behind the doors of the newly opened file. If, during 
creation of that map, the Manager sees something that the 
programmer [narked as “Pre-load,” the information Ls actually 
moved from tJie disk into ItAM. (Hie resource can Ik marked this 
way either by checking the appropriate box in ResEdtt or 
Resource re r, or by using SETRESATTRS.) 

When we look for a resource with a statement like FN 
GETRESOURCE, we don’t actually dig tlirough RAM searching 
for our unique block. The Resource Manager scans the maps 
that are held in memtiry to see if an entry maU’hes tjur needs. 
This entry must be the same resource type wiUi tlie proper JD 
or name. Our Manager, dever fellow that he is, does not blindly 
load a resourt:e wlien he locates the entry. He first checks to 
see if the resource has been previously loaded and, if so, 
returns a handle to the existing iienL 

T(x>lbox calls that ttbiaiti resource handles are governetl by 
very specific rules. Normally, the resource is moved from disk 
to memory, but you can circumvent tins in cases where you 
may wish to do something like record and list available 
resources. Tlie fallowing example records the names of all 
sound resources witlKXJi actually kxiding lliem into ineniory. 

DTH KiidNameSDOO) 

‘ Dtwil loiHl - jusi lfx>k 
CALL SmESLOAtK_false) 

' Cki res counc but don t let it C-xtend pajii 
" tbtr ariJiinn*}' litniu of ihc siring aniiv. 
theCoiiHt - FN C0UNTRESOURCiiS(_''snd 
if rheCoynt > 100 then theCount = lOO 

* GlI each rrsjnirt'c bandit! and c^qucsi 

* info on il. 

FOR 1 “ I TO theCouni 
tHudiS “ ¥H CETiNDmOURCRCand M) 

CALL GETRESINFOt irHndll.. rll)* rTypt!&. rNameS) 
frndNarFie$(i) = rNaiii€$ 

NEXT 

' Rcstont' mimul ncsoun’c Imding 
CALL StTRfc:SL0A1Sl_zTnie) 

The example used COUNTRESOURCES and 
GETINDRESOURCE. These (alls start at tJic top of the biurel and 


continue until they encounter the aging aLsty steel at tlie bottom. 
(Don’t forget, if USERESFILE was invoked, the top of tlie barrel 
may have been cut off, and our point of origin for the searcli 
may have started lower in the drum than expected.) We could 
liave easily examined the resources tliat existed in one file to the 
exclusion of all others by switdiing to calls that contain “1” in 
their names. FN COUNT1 RESOURCES would return the numlKT 
of sound resources in the most recently de.signaled file. FN 
GETUNDRESOURCE would retrieve tlie indexed resource only 
in that file. 

Id's iiring this all together in a routine that searches for 
sound resources in the System file. 

DTH ^ndtiameSClOO) 
orIgHfts = FN CURRESFILE 

* ignore ;inythmg above the Systtm Ole. 

CALL USERESFILE(0) 

CALL SETRESLOADLiaise) 

■ We only want rtiiources in the airrent file. 
theCount FN COUHTIRESOLIltCES C_*‘snd ") 
if theCount > 100 then theCount " lOO 
FOR 1 ^ 1 TO theC^mnt 

■ (kt itHicJScU resources only fmm the tup file. 
rHndi& = FN CETllNDRESOURCE(^"find ",i) 

CALL GETRESINFOtrHndl£r.rID.rType&*rKaiie$) 

£ndNaiie${i) * rNaiiie$ 

NKKT 

CALL SETRESLOADLsTrue) 

' Put things back like we found them. 

CALL USERESFILEtoiigRcs) 

We have now clearly established the limits of a resource 
operation. USERESFILE telLs us where to start searching, and a 
"‘1’’ in the toolbox name tells us that we should stop after 
searching a single file. Absence <jf tlie *"1” forces our search to 
extend to the deepest rcccs,ses of the drum, 

Shahed Responsibilities 

In most cases resources are loaded into memory and ased, 
rather than [usl t>eing inventoried and listed. The conditions 
under which these items enter RAM is another perplexing 
methodology that begs for explanation. The complexity centers 
around the fact tliat the management of a resource becomes the 
shared resfxjnsibility of the Resource and Memory Managers. 

The Resource Manager Ix^gins by examining a resource’s 
attributes to see if ti should be purgeable or locked, and 
all(K:aic,s tlie correct memory through FN NEWHANDLE. k can 
even be loaded into the system heap instead of the application 
heap, so that it may be sharcxl witli odier applications that can 
look downward from their side of the dividers and see it. You 
may recognize these attributes as check boxes in ResEdIt 
dialogs that are labeled Purgeable, Lock, and System Heap. 

Armed with attribute information, the Resource Manager 
asks the Memory Manager {politely, of course) for a block of 
memory that is purgeable (or not), locked (or not), or in the 
system or application heap, information is moved into tliat 
block. Tins is (practically) the only time resource attributes are 
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exilmined — when llic resource is loaded. From lliLs point 
forward, the Memory Manager is in diaiy'e f)f the block. Memory 
Manager calls like HLOCK and HNOPURGE arc used to handle 
the item as it floats aniimd in the heap. 

There is one very importanl cxc:eption to this rule. Never 
use CALL DISPOSEHANDLE on a resource liandle. The Memory 
Manager would airry out its assignment by tlirt)wing away the 
inforn'uUion contained in ific handle, but the Resource Manager 
(w'Ik) was diligently fracking the bltxk on his own [personal tiny 
clipboard) would l>e left with a firm grip on an indeterminate 
chunk of HAM, it's not a preity sight. 

IxKiK AND Purge 

'lb lock or not to i(H k. That is die question. Most of ifie 
titnCj when I am called ufion to deliug a particular re.sourcc 
operaLitjn, I see abiLsCvS that would be loo embarrassing to 
discuss on a daytime talk show. We have a tendency to ignore 
the attributes set up liy the programmer who created tiie 
rescHirce in the first place. As with SETRESLOAD and 
USE RES FILE, we need to remain conscious of tlie creator's 
intent as we manipulate ihese items. 

Assume that your application has a large preference 
resuuree that is loaded at startup. If we lock this piece of 
information in place, we have kxked up a liig, tHfienvtsc* us:jl>le 
piece of binary real estate. Making it non-purgeabic would liave 
similar effea. It may be our inleni to move the entire resource 
inln a gloixil rct:f>rd nr to examine individual picxes and branch 
to other operations. Hither way, this resource wouki Ix^ markcxl 
as purgeable by it.s creator, but must temptirarily he held in 
memory. We do it like this,- 

rHndlS " FN GfcTRESOURCEL'PREF". myPrpfTn) 

Wm IF rllndlfi! 

' IlcL'sinJ Uic liTOdIc. 

hStaie - FN HGETSTATRCrHiidlfe) 

' iVLifct: sun: Jt stays in mtnuiry. 

OSErr = FN HNOPURtlE(rUudU) 

■ Hintllf ft-soiirtc upcniKMts Jiot’. 

' then rrstiiiv the hiiiidk' iL> oripm! sliJti:. 

OSErr = FN HSETSTAT£UHndU,h?;iaO!) 

KNh IF 

Some ttx>llx>x txiulinc^ handle puiging without a [iixigramnier's 
iLs.si.sianc'e. Picture resources are among ihe most abii.sed in all of 
Mac-doiiL Take the folkm'ing I really Iml) ex^imple. 

' Bad cJtanipk'! Oou’T try this a I lionif. 

\m L»l,b.r 

rlindia “ FN GETPICTlJRRf.ntyPiciurelDj 
OSHcr - FN HLOCK(rHndlfr) 
t:8 = [rHndl A]+_picFr^i(j(; 

CALL OFFSETRKCrtt*-!* -t] 

€AT,L DRAWFiCTLJR£CrHndl&.t) 

CALL DISPOSEHANPLE(rHndU) 

This example w'as so wretched that if was pthnful to t>'pe, Ixil 
it rejiresenrs tlie type d* resourc'e liandling that Is tximmon in most 
programs. Hie first error was to Itxk the jiicture liandle. If this 
piemre w^as to lx used often during the course of an apjiiicalion 


(as miglit lx die case witli a ukiI pidefte pkiiire), its cTeator w^ould 
have marked it as non-purgeahle. In most cases, even the 
[iiugeable attrifxite would Ix" turnetl off so dial the pitture could 
be expunged il required. Leaking is generally a tiad tiling and 
woLilti normally lx* done only on a lemporijry basi.s, (Kememlxr 
HGETSTATE and HSETSTATE?) In our case, the HLOCK was 
unnecessary', since QuickDraw manages this panicular resouK:e 
during its operation, and undesirable since kw-level picture 
ofXTaLions may attually move or resi;ie the pkture resource. 

ejur next major misiake was to assume that llic picture was 
loaded into memory. We immediately went to w'ork on a 
resource handle without checking it for validity, 'fhen, wc 
disfHiscxl of the hanrlle, which was being Joindy irac ked by the 
Resource Manager and the Memory Manager. Since 
DISPOSEHANDLE is a Memory Manager call, the Resource 
Manager was left out of the operation and is likely to cau.se 
.serious damage wiien it next reaches for that res^iurce. 

Here's how we should have handled ihe ojXTation. 

DIM 

rHndl 4 - FN nHTPlCTUREt_ayPictureID) 

LONG IF rRnflU 
1 ” [riliidlk]+_pieFrame 

CAia. OFFSETRECKt*-!, t) 

CALL URAWPICTUREirHndU.t} 

END IF 

If ihis was a .startup picture, it would |iif>hahly never lie 
needed again. The moment that the memory il ocx'upied was 
rc*quircd fVir some trther operation, the piaure %vfnild lx purged 
frtim IMM. On the cjfher iiand, if ifie application’s partition was 
large and the trsers recgiirements small, it iiiiglu remain in place 
tor the duration. 

Later, when the user decided to view^ the application’s 
‘‘About" Ikjx, we would use exactly the same routine to dispkiy 
the pidure a second time. If plenty of space was available and 
the picture had managed to remain in memr^ry, it would not lx* 
reloaded. A handle H> the existing data would fx reittmcd from 
FN GETPICTURE. If constraints had forcetl tlie rc-stiurce out of 
memory, it would be reloaded as a result of the call. This 
tfeliuggeti exam (lie w';ts more memory <■ flic k:m, and took fewer 
lines of ctxie. 

Handle Hand-oei- 

Whilc tlie ownership of resource handles .seems to he 
preordained, we may still exerci.se contrail over who will 
ultimately own the handle. A call to DETACH RESOURCE does 
ifiis. It pulls the resource’s entry from a file’s re.source map. It 
does not remove ihe handle from memory or change the 
attrihuies of that liandle. After this call, the Memory Manager 
controls the block, and tlie Kesource Manager ceases to 
acknowledge its existence. If you wish to disfiost^ of it, you’il 
have to use DISPOSEHANDLE. 

While there is no call that completely releases a Memory 
Manager iuindle to the control of tlie Resourt e Manager, tliere Is 
a procedure lhai turns a handle into a resource: 
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ADDRESOURCE. TIiLs call takes a great deal of .setup and is l>esi 
documented in FN pGreplaceRes in the Runtime.INCL file of a 
Program Genenitor project, Bui there are some imporrani rules 
that deserve allention. Wlien a resource is added, ii Ls added to 
llie current resource tile. Use CURRESFILE and USERESFILE to 
cliange this during such operations. Adding a re.source is a blind 
operation that allows duplication. If you add a preference 
resource to your application three times, you 11 end up with 
iliree copies of the resource in your file. 

Sum Execution 

Because most folks have a hard time understanding 
resources, there is a tendcricy to wiite out a resource every Lime 
it is modified, Apple engineers are no exception* Most of us 
remember the early days f)f the Macintosh B40AV, An 
uninformed ROM rai patched the toolbox call 
CHANGEDRESOURCE to make it cal! UPDATERESFILE each 
time it was called* TTils was a bad thing. Id me explain why. 

When your program calls UPDATERESFILE or 
WRITERESOURCE, the entire file may be written to disk. 
Remember thal resources are nor really magical. They occupy 
space on a disk, and are ordered according to strict internal 
guidelines* If you replace a picture tlm is 50K with one vlmi Ls 
100K, ihcTc is no sorcerer’s potion that comprcs.ses die new 
resource into the same space used l>y tlie old one* The file is 
simply rewritten, starting at die l)eginning of the old 50K resource. 

When ihc AV’s were first released, folks cijmplaincd that 
re,source handlers like ResEdit and Program GencTator slowed to a 
crawl. IhLs Ls because a simple c>ix;ration (CHANGEDRESOURCE), 
which was supposed to set a single bit in a single flag, ended up 


rewriting the file. Tie luuliiy is that it Ls almost never necc^^sary to 
update die file or write its resources. Tils hap|K'ns automatically 
when tlie file is dosaL 

Tiere Ls one additional feature cT CHANGEDRESOURCE that 
deserves attention: You should never call CHANGEDRESOURCE 
on a purgeable block. When the file is dosed, the Resource 
Manager scans its list to see what has Ix'en modified. Then it 
rewrites the file with these new items in place. If, in die inierim, 
the Memory Manager has purgetl the bkx:k, you wiD see random 
data written to the disk* If you have ever seen a file expkxle fmm 
a few hundred K to several megabytex, this is Ihc likely reason. 
Mark rest>urces in the following manner to prevent this problem. 

OSRrr - FtJ HN0PlffiGE(rHndl&) 

CALL CHANGRMES0URCE[rHndl&) 

Conclusion 

Our list of rules to live by grows ever more complex. In 
die olden days, we were jii.st supposed to rememl>er not to tug 
on Superman's cape or spit into the wind* Now we must 
watch resource auributes and referee a tenuous cease-fire 
l>ctwcen two headstrong Macintosh Managers* My friends from 
Trinidad might beg for simplicity. “And me anudder mimagcr 
Dees ones too complex*’’ B 
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TECHNIQUES 


By Jamie McCornack 


RtGISTAnTION NUMMft: 
234 - 124 - 454-560 


Serial Ki ller 


Easy and effective serial 
number management for 
electronic game 
distributors 


Tills inalcrial isn't rocket science —^ it is 
just an easy way to do something that you 
need to ckx 'flic ccMnpuier gaine business is a 
dog and pony show, and this Ls alx>iit how to 
deal with pony poop. I am offering oo 
glamour here, l^ut i might save you a couple 
of days work* 

An Import.wt Part of Every Breakfast 
Games need serial nuiiilx‘rs more than 
any other software. They also need 
individual serial numbers for individual 
customers Ix'cause 

• People play games for fun, and paying 
for things isn't much Fun. Given a 
choice, the average game player will 
say, ’'It's only a game,” and never iliink 
twice alxjui ethics. 'Ihese people would 
never go to their Porsche dealer and 
fake off with a red one, saying, "'It's only 
a Porsche," even though Porsches are 
sup[x^sed to [yc fun tfX). 

• People will res[X>nd positively to paying 
ftjr games if‘ they are reminded gently 
and given the opportunity to pay at 
their own paee. Ambrosia recently 
bought a company Humm-V from 


voluntary contributions “ folks who were willing to .send in 
$t5 to $20 for a serial number. 

* llie reward for having a .serial number need not be big, but 
there must be some reward. Ambrosia (to use the most 
succe.ssful example in the Mac electronic distribution world) 
offers contests and the like to registered users. However, the 
main reward Ls that ilie gatiic stops asking for a serial number 
every' time you play it. While the reward need not be big, it 
needs to Ix^ immetliaie. So, the game iLself needs to re.spond 
to serial numlx^r input. 

• Having a single serial numlxiT hard-wired into your program 
doesn’t work. It will immediately find its way onto the 
Internet, and the folks who “crack'* your program will think 
that they belong in the next William Gibson novel 

TTie glossy b<ix people do not have this problem as much, 
since they publish mostly on CD-ROM which costs |K*anuts to 
reprcxfuce, but much more to copy. To copy protect a CD-ROM, 
all you have to do is insist that I he CD be present (or some 
200meg file on the CD) Ix^fore the program runs. At the current 
state of the art, your CD e exsts you under a buck to produce, and 
a copy casts the freelance pirates about $10 — so, they might as 
well !)uy an original. 

However, if distributing games on floppies, compilation 
CDs, or via modem, ilie economics of sc'ale work against you. 

A floppy loaded with your dam ;md labeled costs more to 
produce tlian a blank floppy (purchased in !x>xcs of 20) costs a 
jxxential pirate. Imagine what the lKX)k Ixxsioess would Ix! like if 
Ixx)ks txxst publishers six cents a page to prim, and every person 
in the ajuntry had a nickel-per-|xige copy machine at home. 

Q>mpilaLion CD’s (One Thoasand Great Games for S 19.95) 
are an effective way spread around demexs and sbireware games. 
However, the buyer has my game (and 999 other games), the 
distributor has $19.95, and I have nothing. Now J need to 
encourage the buyer to spend a little more, Blectronic 


jamte McComat’k is an amateur programmer and professional writer in the Mac game genre. He is a project editor for 
Hayden’s Tricks of the Mac Ganu^ Progmmming Curi 4 S and he WTOte Reai Ufe Gamm^'rks for Mclrowerks' Gamewerks SDK. 
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cliNtril Ji ll ion Ls die same scenario, except the [)uyer receives a bill 
from AOi at tlie end of the monlfi, and 1 still have nothing. 

Well, not tjuiie ntjiliing. What 1 have is a marketing 
oppcmimity. The opjxjrtLinity to sell something — an end to the 
“please register” reminder, a game cnliancemeni, and early 
access to my next game. Tlic easiest and most effective item For 
this market is a serial numlier, Here are some serial number 
guidelines. 

• Tile serial numlier siiould Ik unique, and the graiificadon 
sliould Ixt immediate. The game program needs to accept and 
reward any valid semi numlx^r, and spurn any invalid serial 
numIXT. 

• There slunild \w. m<Jre invalid numbers possible than valid 
ntimbers. There shouki be a minimum of 1000 wrong 
juuiibers for every right number or the “Hunt and Peck 
Hackers" will perform Imile force solutions instead of tk>ing 
their histcjiy htauework. 

• The system should be easy For you, easy for the registered 
user, and easy For the folks iluit answer your 800 line. Fill out 
the Masu‘rCard sli[>s, and give out the serial numixTs. 

What ixHis GitwiiKATOR Generate? 

Genemtor tranks out a couple tliou.sand serial numixrs per 
second, and saves them as a tab delineated Excel file. Most 
cLiiahases can import Excel data. You can select start and end 
numl)ers from 1 to 999999. 1 recommend that you generate a 
reasonable r|uanLity of numbers — you probably don’t need a 
million .serial numlxrs yet, nor <io you w^ani to devote 25meg to 
storing the hie. Note tliai Genenitor is a 68k Mac program, but 
since ii pr<Kluc:es alx>ut 120,000 serkil numbers per minute, it Ls 
prolxibly not vvt)nh svriting an Accelenutxl for PowerMac version. 

1 import my serial numlxrs imc) a FileMaker Priv document. 
FileMaker gar!>les die first record in the list because it stumbles 
on the Excel header, so I start my list witli 0. 1 delete die first 
record, wdiich leaves me with staial numixr 1 heading the list. 

Generator's first function, CalcutateValues(), names the file, 
.sers the Excel header, forces tabs into the data where netxled, 
and saves the serial numlxrs anil t:ustomer nuinlxTS. 

Making the numbers unique 

For clarity, the twelve digit numbers generated by Generator 
are grou|xxi in four dumps of liiree; xx.x-xxx-xxx*xxx. 'Ihey kx>k 
just like Honkhtrad’s numliers, but they’re not. ITje unit|uifymg 
algorithms used herein are different from tlieirs, and yours 
should lx* diFferent too. You'll have to wmte your own unique 
ProduceVatuesQ function if you want your own unique .serial 
numlxrs, liui this version of Produce Values!) will give you some 
ideas. 

Idea Produce Values () dtxs much of its work with strings, with 

numerical input converted via LongToStf(). With minor 
dianges, your version am output nunilxTS with charactei^s 
(both upper and lowercase) and symbols as well as digits 
(yes, I lie resulLs arc* still called serial numbers). 

Idea *^2: LongToStr() places a string lengili value in str[0], and a 


niii value in slrpast char + 1], creating a !aring that is IkhIi a 
Pascal string and a C string. Why? Someday you might be 
programming cmss-plaiform, and the Mac prefers Pascal 
strings, and Win tel prefers C strings, and 1 don’t know what 
Nintendo or the PlayStation use. However, ilierc arc a lot of 
potential customers out there, and they don’t all use Macs. 
Sure, it costs us a character, but who is going to key in a 255 
chit miner serial number? 

Produce Values!) briefly converts the string values ‘O' thiough 
*9' back to single-digit nitmbcrs, this is purely for the sake of 
clarity. For example, T you w^ant to use uppercase lettei:s instead 
of digiLs, convert 

fit “ vfl1StrFl+4l ' ’0^ 

to 

uLl = vaistr[i++l - ; 

and the number-stirring line (which converts 123 to 32U In tliis 
exiunple), from 

val] “ (d3-t00) + !d2) + (dl/lt)0); 

lo 

va1l “ {uL3*676j+CuL2)+!uL!/6/6); 

This converts ABC to CBA, Dsing uppercase letiers makes 
the serial ‘number'' digital in ba.se 26, giving 676 passilile two 
letter combinations. Using upfxrca.se and loweraise letters, plus 
the ten numerical digits, gives a base 62, with two charaaer 
combinations and about 15 billion four character combinatioas. 
No wonder Apple hasn't ntn out of owner resource ID numbers 
yet. 

In this example, the first and fourth tlirec digit number 
groups reflect the cusiotncr number- OOO-xxx-xxX'001 is 
customer ^1, 076-xxx-xxx-345 is customer number 76,345, etc. 
TFie second number group is a random-appearing response to 
numlxr group one, and the ihird number group is a random¬ 
appearing response to number group four. So, the first 999 
cirstomers arc customers through ^^999-^* 

Why don’t we have a ciLstomer 4)? We are *i) is for in- 
house testing, 

CirstomcTs #1 through ^^999 ail have the same second 
number group (930, in this example) and customers #1 and 
^4,001 and #38,001 all have the same tlrird number group (it 
happens to be 228). 

The algorithm for generating response numlxrs is pretty* 
simple in this example. 

• Get a three digit number group Ce.g. 123). 

• Add 13 Ce.g. 136). 

• Swap the first and third liigits (e,g. 631)* 

• Multiply by 3 {e.g. 189.3)* 

• Subtrata the origirml * 2 (e.g, 1893 - 246 = 1647). 

• If tlic result is negative, converr it to iLs absolute value. 

• Discard all but the la.si three digiLs (e.g. 647). 

In rtral life you will want to u,se different seed numixrs to 
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add (or subtracl) in .sttrp 2, different swap patterns, different 
multipliers, and you may want to swap and/or mingle digits 
from the first anti fourth number groups. There are many ways 
to make your particular serial numbers your own. 

Simon says.,,play 

The game program requests serial nutnlx.T input from the 
player, and cunfinns or denies the validity of diat nunilx-T. D<k:!s 
it run Generator backwards? Nope. 

Tlie game generates second and third number groups in 
response to the first and fourth number groups using exactly 
the same code as Generator, and checks them against the 
second and third number groups entered by the player. Are the 
generated and keystroked numbers identical? 

If you are a l>eliever in the heavy-handed school of 
registration nurnlx.'rs, the game can refuse to am until a suitable 
nuinlxT is entered. A lot of gIossy-lx)X software use.s this system. 
The only value I see from it is that if the buyer sends in a 
registration card with tlie nuinljcr tliereon, you know who to yell 
at if that number shows up on a BliS or on the piraies.com home 
page (iny apologies if there rcilly is a pirates.com t)ut lliene). 

If you are lighi-lianded, a simple ‘thank yoif splaxh scrc'en 
might well suffice, and deactivate the gentle registration 
reminders iJiat keep popping up. Also, flag this a)py of the game 
as registered, eitlier in the prets file or in the application iiself — 
do not demand the numljer be keyetl in before every game. 

Till: Number of the Bfast 

Simon Beeblebrox, #958331 

One thing electronic distributors can do that glassy box 
distributors cannot, is personalize serial numbers. If someone 
buys a game off the shelf, tiiey expect to Ix' able to go straight 
home and play it with no further haxsle. However, a customer 
wfio is mailing in a registration fee fcjr the enhanced version of 
an electronically distributed game^ or is phoning you with a 
pencil in one hand and a VISA card in the other, is going to 
give you tlieir name. If you like, you can integrate that name 
into their serial nutnlicr. 

NameNumerator converts tlie first 24 characters of a name 
to a six digit decimal number. The six digi! number (e.g, 
95H331) could be coinlhned with the previous serial number 
generator (e.g. 9S8-xxx-xxx-331) to create a real challenge for 
the crackers. 

Let's lake a kx>k ai NameNunx^raroTs most signific'iini funciion. 


Get VaJyt: 

(ktValiieO takes a string up tu 2%^ di;u> lunj;, and neUims a six digii dtdmal ntiniber, 
in ihe form of a six character sirifi|». 

void GetValue(Str2*j5 valStr, Str2ib retStr) 

r 

long 1: 

for (1=1: 1 <= 6; i++) /Aoad fiist six clw codes 

retStrtiJ = (valStrUl % 10): 
for (i“l: i 6: 1H ) ff] ;oad next six char cak&O through 12) 


retStrli] = ({retStrlij + valStrfirG]) % 
for C i=l j i <“ 6: i++) //Lmd third six char codes (13 through 18) 

rtnStrliJ = ECretSi:r[il l valStr [1+12]) X 10); 
f or (1*^1; i 6; i t f) //t JDiad fourth six char codes (19 ihmngh 24) 

retStrfil = E(rotStr[iJ + valStrli+lS)) % 10): 

//Add 257458 (kinda...) ami ‘O' 
retStr[i] - {(reiStrlH + 2 ) S 10) + ‘OV; 

retSlr[2] = ((rEtStrUj + 5) % 10) + 

re|Str{3] = {tretStr[3l + 7) % 10) + *0^t 

retStrl4j UretStrf^l + 4) % 10) + ‘0*: 

reiStrlS] - {(retStrfS] + 5) % 10) + *0't 

retStrfel = UretStrifil +8) K 10) + ‘0*: 

I 

rhe first half of GetValue() takes the individual characters of 
a Str255 (the registrant's name), strips all but the last digit of that 
clmracter's ASCII code, and places that digit in another Str255. 
After the first sbt digiLs are placed (valStr [1] placed in retStifl], 
vatStf [2] placed in retStr{2]. etc.), the next six are added to the 
fiisL six tvalStr [7] added to retStr[l]i valSlr [8] added to retStf[2] 
etc,) and al! but the Iasi digit us stripped from the re,sultant. This 
process is repeated through 24 characters. However, to 
distinguish Clifford nummel Throckmoritm-Whirney from 
Clifford Hummel Throckmorton-Whitfield, you can repeat as 
necessary\ 

The second half of GelValiie() adds ihe arbitrary seed 
mimljer 257458, sona.,. 

Well, it\s not quite adclifion. Actually, we arc adding the digit 
from the hundral thousands i:t>lumn to retStrfl] and stripping off 
all but the least significant digit from tite result, adding tlie digit 
from tlic ten thousands column to retStr[2], and so on. Then we 
add the A5CII vaiue o{ Lite chaniiter 'O', so iastead of liaving tlie 
aciiial digit values in die string, we get the ASCII values of the 
digits, 0 + ‘O' == 'Q‘i that is, 0 + 48 = 48, w'liidi is the ASCII exxie for 
the cliaractCT 1 + *0' ^ 'V; that is, 1 + 4H - 49, which i.s the 
ASCII ctxle ft>r the cliaracter '1 1 

So yt>u have your teiemarkeling people with 
NameNumeraior up and running on their Macs, and when folks 
Gill in their orders, they can say, "How do you spell your name, 
Mr McCi>rnack? Your serial numbcT is...'’ and that Ls w^hy you 
need to use genuinely aflbjtrary seed numliers. 

I’or example, 

Tot (1=1; i <“ 6; i++3 //IjDftd first six char codes 

retStrLiJ - (valStr [il % H): //In base 13 

will throw' a Spaniard in the works, and 

Fof {i=l; i 6; i++) //IjkuI First si* ch#/codes 

retStrlil = (valStrUl * (10 + i)); //1nhav:(IO + i) 

will scramble things even ftirtlicr. 

Or perhaps you'd like to use alphabet characters, 'lo start the 
above six digit example w'ith an uppcrc’ase letter, change rhe first 
line of tlic second half of the routine to 

retSrrfl] - ((reiStrtl] + 2) % 26) + 'A^: 
which adds a rantk>m-like number frc3m 0 and 25 to die AStdl (xxJe 


60 


StldAL Kjilcr 


MAfTRCHMACiAZINI! • I'RIJRUARY 1997 










fi[)r 'A\ giving the tiJlJ range of capital letters (since *A" + 25 = T), 

0>NfXLlSK)N 

Big Brother, #964752, is Watcliing 

What is the advantage of personalized serial numl^ers? Many 
people wliQ would otiicrwise disiribute a generic: serial number 
will balk at distributing a serial luimlx^r which only works with 
their name, thus exposing them as the culprit- However, the 
typical game pirate is noi worth harassing — w^hat are you going 
to do, have your lawyer's mom call the pirate's mom to tell ht?r 
she has a natigliiy kid? 

You t^ould build a serial number from a name and phone 


number, and verify tlic phone number by having your 
telemarketers say, "We will call you \%ick in three minutes with 
your serial number" when the order is placed. However, if 1 
were publishing a high-bucks 3n animation program, 1 would 
want to discourage folks from buying one copy and putting it 
on every workstation in the art department I could say, "You 
don't like dongles? Then 1 will give you a serial number. 
However, it will only work in conjunction with your name, 
your credit card number, and its expiration date. If your .system 
isn't secure enough for your credit card data, maybe it isn’t 
secure cnougli for ()ur program, either. Are yriu sure you don't 
want a dongle?” El 


Help Make MacTech Work 


MacTcch wo. nely heavily (^n 

ouLside writers for most of the material that 
appears in our pages. If readers did not 
participate in the magazine, sending us their 
ideas and uiking tlK^ lime to write articles, diere 
would k' no MacTetk Mac‘RH:h Mi^zim Is 
not a staff of writers serKling a consiiint stream 
of one-way messages outwards; it’s a living, 
evolving network of readers conversing with 
one anotlier, etlutming one anklier, sharing 
thdf knowledge, tlieir eJtjXMTt^ice, llveir inieiest, 
their trials and tribulations and joys and 
sucx^ses in tlte coastantly unfolding of 
programming the Macintosh. MacTech 
Maasizim doesn't just luippen: it's what the 
community makes it, If we carry reiions of 
fuUire trend.s and technologies, if we teach 
useful incllnxis, if we review new Ixxiks and 


Kx>ls, if we provoke thoughc pitnide help, ride 
ilie wave tjf ainent Interests and cx>ncems, it is 
only k'cause we retied the thoughts of our 
readers, w1h> six^ak llirougli (xrr pages. 

YotJ are invited lo involve yourself in 
this exciring con versa Item aittongsi readers. 
No matter who yf)ii are, no matter whai your 
ciedeiKials may Ix^, if you have a tale lo lell, a 
trick to share, a tcxhnkjue to teach, we warn 
you to coasider joining the fajiriiy of those 
who write for MacT(xb. 

fXm't just wait for a topic to be covered 
or a technique explained in MacTccb! Take 
a^sponsibiUty! Write us an article yourself! 

To write for MacTech^ just send for our 
Writer's Kit. It's a Microsoft Word file 
containing the Slyles you need to use, and 
giving kx.s of helpful advice and inlomiaiion. 


including all the legal .stuff. You can let us 
know what youVe writing alxjut, or^ if you 
want to, you can just write the article and 
spring it on us when it's done. iNote; We also 
have a need for people willing to make 
themselves available to write occasional 
produci/lxxjk reviews.I If we publish your 
article, you 11 k* paid for it! 

Write to us, the editorial staff, at 
editorial@riiadech.com (or one of lire oilier 
addresses li.^ed frn jxige 2 of the niagazine). 
Take the future of MacTech Magazirte into 
your own hands! 



DUbert hy Scott Adatm 

rtf NEW INVENTION WILL 
GENERATE A SOLID PARTICLE 
BRIDGE TO PERMANENTLY 
CONNECT THE EARTH TO THE 
moon! 



WELL, in NO SCIENTIST, 

BUT WON’T THAT DISRUPT THE 
EARTH’S ORBIT AND CAUSE 
AN ICE A6E THAT WILL 
DESTROY ALL LIFE ON 
THIS PLANET? 


S.MpWBWo 




YOU THINK IT NEEDS A 
LITTLE WARNING LABEL ? 


JUST OONT 
LET KIDS 
USE IT. 
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metrowerks 


Mike Lockwood, Debugger 


o ne of the mosi imporiLini, yen least 
understood part of the Mac development 
process is the debugger. Sure, everyone 
knows how to use the debugger to step 
ihnjugh your source code, but I've always 
wanted a peek beneath the hood, a chance 
to see how a debugger really works. This 
month's interview is witli Mike LtxkwtxKi, 
debugger extraordinaire. 

Dave: You worked at Apple four 

years before you came to Metro- 
werks. Wliat did you do there? 

Mike: 1 first sUifted working on 

development tcx>ls on my wn, Ixfore I 
joined Apple. I wrote my own MacApp 
debugger as a side pitjject, and when I got 
it working I sold it to Apple. Apple 
contracted me to finish it, and it shipped 
on K.TO. as SoiiroeBug. S<x)n after dial, I 
joined Apple as an employee and worked 
for a year on the debugger For a new 
integrated developmenl environment that 
was to replace MPW. 

After that project was canceletl, I 
transferred to the System Software gn)U[) 
and worked on the Finder team. At the 
lime there was no source level dcl^uggcT 
that cmild debug Fintler extensions, ,so I 
kept working on tlie debugger ftiom my 
previous project — so 1 could use it 
myself'. I added suppon for debugging 
threads and shared libraries, and it was 
soon being used by a number of 
different groups within Apple. Since il 
was an underground, guerrilla 
programming effort, I deeided to call it 
VoodooMonkey. Ihen when no one was 
kxiking, .Sfjmet^ne snuck it on one of tlie 
Developer CDs and VoodooMonkey 


Mikk 1/x:kwood, Dbbuggbr 


shipped outside of the company. Since ihen, it became 
somewhat of a cull t lassie. 

After working on the Finder team for awhile, I became 
interested in working on tieveloper lcx>ls again and wanted to 
move back to the East eoast. S(j I transferred to the Cambridge 
office to work on the Dylan project. I here, 1 wrote the 
application framew^ork for Apple l^km, ^nd served as the 
main guinea pig for the Dylan compiler and development 
cnvtroninenL After ihiU [)rtjjcci got canceled, there was an 
opportunity for me at Metrowerks, and I joined them the day 
after I left Apple. 

Dave: How did you hook up with Metrowerks? 

Mike: Metrowerks first contacted me in tlie Fall of 1993. Tliey 

needed a 68K debugger nu!> for CcxleWaiTtor, Apple only had a 
PowerPC' version of Debug^iervices up and ninning. Greg 
Galanos called me to .w if he could nse IkHiuggeriNTT, w hich 
was the debugger nub I wrexe for V<xxl(X)Monkc 7 , At the time, t 
didn’t know inucli at all alxxit Metrowerks, oflxr than they were 
working on a C/C++ compiler for Powerl^C I wanted to help 
them out, but I also w anted to avoit) some of the political 
fin)lilenxs i ran tntt> after VcxxkxiMonkey shipped. So, 1 diretied 
Greg to go thrcxigli the propter channels in Cupeiiino, 

I knew Greg would never lx able to cut llirt>ugh all of the red 
tape, and 1 w^asn't .sure I would ever hear from him again. 
However, he allied me iwo days later and said "Hey, I just 
licensed the sources to DchuggerlNfr fnnn Apple." Now' 1 
knew' I w^as dealing with a force to he reckoned wirh. 

I continued to talk to Greg and other jxoj^le at Metniwerks, 
and provided s<3me inftjnnal tedi supjxm for DebuggerlNl'l'. 
When it was dear that the l>ylan projeti was going to lx shut 
down, 1 talked more seriously with Metrowerks alx>ut joining 
the company- Dan Podwall, the original author of the 
Metrowerks debugger, w'as luisy w'orking on the bn>wscT and 
they needed someone to take over itie debugger 

Dave: What exactly is a debugger nub? 
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Mike: A debugger nub is a small program that controls a 

program lluil is dt?huggecl, and Ls respoasihle for things 
like setting break[X)inLs and single stepping tlirtmgli code. It 
provides a layer l>etween the main debugger apf^lkation and 
the low level system siufF. I'ht discinaion is important in the 
case of two machine del)ygging, l>etiiu.se the debugger nub 
runs on the machine being debugged and tlic debugger 
application runs on a different machine. MetroNub is our 
debugger nu!> for single machine MacO.S anti Java debugging. 
We have oiher delsugger nubs for deljugging ctxJe running (rn 
other platforms. 

Dave: How does MetroNub interface wdth the 
Metrowerks debugger? 

Mike: MeiniNub is a system extension that provides an to 

the Metrowerks debugger tiiai su[)porLs debugging functionality 
like single stepping. MetrrjNub ex|x>tTs a strucuiie full of inixed 
inode fuailion pointers via a Gej^alt seleaor that die debugger 
application c'an call. MetixjNub also interfaces with various parrs 
of tlic OS. For example, it patches die Resource Manager to 
ira(k where axle resr:jurces are loaded in memory, and uses an 
undtxuinenLcd IVtxcss Manager API to suspend and nesume a 
process that is being debugged. It also paichcs the 68K 
exception vectors and registers callback functioOsS with the 
ik)werPC Exception Manager and the Ml^ kernel so it can Ix" 
notified when exceptioas (xcur. 

Now Id's examine wfiai happens when you single step tlmxigh a 
line of code. At lliis point, the pnrgram is already stopped, 
nxnining that MetroNub liad iiiready told tlie Pnxess Manager to 
.sirspend the program's process and make it ineligible for 
sclieduiing. Tlie delmggcT application then ciills the MetroNub 
"Step" command. Wien it makes tliis call, it would sptx:ify lo 
MetroNub wiiether to step into or step over hinction caLLs. It 
w<xjld ;ilso spexify a range of addresses for the program counter 
so Mem>Nub will not stop exceuiion again uniil tlie Ls outside 
of this range, Wlien stepping though source code, tliis range 
would correspond lo a single line in the source code. 

MetroNub would record tlie PC range SfXdTied, and would tlien 
tell tlie Prcxc-ss Manager to resume the process. Tlie proa^ss is 
then cligilile to lx scheduled again, but will not amiJilly resume 
until tlie deixigger application calls WaitNextEventO. After it Ls 
rcst hcxJuled. H«)me of MetroNub's code tliar was left on tlie call 
chain of llic program Ixing tlehugged will resume execution. 
Before MetroNub returns control to the program being 
debugged it restores all the registers and seis tlie trace bit in file 
prtxes.sor's siatus register. The trace bit telLs the prexessor to 
cause a trace exception after each instruction is executed, 
MetroNub ret^eives these trace exceptions, and processes tliem 
until tlie program c:ounter hills out of the specified range, Ihen 
MetroNub tells tlie Pixxc^s Manager lo do an immediate aintex! 
.switch from the program being debugged lo the debugger 


application. Tliis leave's some i>f MetroNub's exception hancUing 
code on the call chain of the program Ixing debugged, whkb 
will resume after the program lieing debugged is rescheduled liy 
tlje PTXx:ess Manager, 

Dave; Wliat language is MetroNub written in? 

Mike: MctroNul) Ls written almost entirely in C++, witli just a 

small amount of 68K assembler. Tlic assembler is used only in 
a few places wliere it is necessary to acceSwS registers directly or 
execute some uncommon 68K instrucrions, for example, the 
68K exception vector patches and .some of tlie Resfuirce 
Manager parches are written in assembler, MetroNub is nuxstly 
68K axle, and only contains a small amount of Powerl\; glue 
code for some of tlie calUxicks ii registers with the OS. 

Dave; But how does the link between the source code 
MetroNub happen? 

Mike: MetroNub doesn't know anytliing alx)ut tlie source code. 

Tlic debugger application handles the mapping from source 
code to olifcct axle ofifscis, Ixiscd on ioftirmaiion in rlie sym file, 
which is generated by the compiler and linker Sup[x>sL' you 
w'ant to set a breakpoint at a i^rtain line of source code. The sym 
file contains a uihle dial maps tlie offm in the .source file to an 
offset in tlie object code for tlie function containing iliai line of 
code. A different table in the sym file is ilien used to tiaaslate die 
ofiscL in die function's objetl ctxle to an <jfiset into a CFM code 
fragment or a axJe a'stjurex:. The debugge-r dien tells MetniNuh 
to set a breiikpoint at the given oRset within the code fragment 
or erxle resource. 

’Ihe debugger application does not have to know wltore die 
ccxle Ls loaded in memory or if il Is even in memory at the time 
tlie LtscT sc'Ls die lireakpoinl. IF it is loaded, the debugger will 
convert the offset lo an absolute address and insert a trap 
lasmiaion at the address where the breakpoint .should l>e set. 
If the code is not loaded yet, MetroNub remembers the 
breakpoint and instails tlic trap instruction after ilic code is 
loaded but liefore die program Ls ulile to execute the code. 

Dave: What changes did you have lo make to your 
design to deal witli Java? 

Mike: Fortunately, no major design c hanges were needetl to 

support Java. That was gcxxl news for us, because litneUo- 
market was important. Our debugger could already debug two 
diffcrcnL processor architeetures (68K and PowerPC) 
simultaneously, so adding a lliiid arcliiieeture was not difiieuk. 
We just treated Java byte codes as if they were assembler 
iaslruLtioris and the Java VM as if it w'as a mieioprocessor, and 
the debugger arthilcclure we already had in place wxjrked 
fine. 1 liad to w'riie a new iniplementatiun of the symbolics 
erode .so it trouid read .symbolic information from Java class 
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files and Zip files iastead of' a .sym file. I also had to add an API 
to the Metrowerks Javji VM so lVfetroNul> t:ould comrnunicaic 
witli die Java VM and control the execution of Ja^'a code. This 
approach liad the nice side effect that it is passible to debug 
both 68K and PowerPC C/C++ code and java code 
simullanctiasly with a single debugger 

Dave: A lot of companies have said that they wilt no 
longer support the 68K. Do you think learning to 
debug 68K code is a worthwliile investment? 

[Mike: 68K is Ixxximing less impoitanu ixit a gcxxl undcrsianding 

of 68K uxJe is valualile when debugging on System 7^ even if 
you are writing PowerPC native code. Since much of the 
operating sy.^em Ls .still emulated 6BK axJe, it is not uncommon 
io hitve to debug 68K code tin a PowCTMac. 

Dave: What's your feeling on how pet^ple shouid approach 
debugging? Should they k-am MacsBug? Should they' buy 
a copy of Jasik's Debugger? Learn PowerPC assembler? 
Got any good book recommendations? Are there utilities 
people should definitely have on their hard drive? 

Mike: The Metrowerks debugger is strictly a high level 
tiebugger You also need to ha%'e a low level tiebiiggtir like 


Want to subscribe to MacTech 
Magazine? Contact 
<mailto:orders@devdepot.com> 
call 800-MACDEV-l or 
805-494-9797, 
or fax 

805-494-9798. 


MacsBug i)r Jasik's debugger installed when debugging with 
tlie Metrowerks debugger. Jasik's debugger Is aauaUy both a 
low level and high level debugger, so if you like Jasik's 
debugger, you don’t even need a copy of die Metrowerks 
debugger! Jasik's debugger is very powerful and has a lot of 
features that no other debugger has. But many people find 
the Metrowerks tlebugger easier to use. 

Nowadays, it isn’t critical tliat you learn PowerPC assembler, 
unless you need to write very low level or very optimized 
code. But for del lugging purposes, it is often useful to have 
basic reading knowledge of assembler, even if you do not 
write it yourself (1 liave written a lot of 68K as.sembler over the 
years, but haven’t aaually Imd a need to write any PowerPC 
assembler yet). But understanding how to read and debug at 
the assembler level can lie very useful at time.s. 

Thcfu are a numlKT of utilities available that can help you with 
debugging. You can use the Debugging Memory Manager 
from Apple to help catch memory problems in your 


rhere are a number of extensions, like 
EvenBetterBusError, DoublcDispose, etc. 
that are available from Apple that watch 
out for common programming errors 
when using the Memory Manager or 
Resource Manager. 


a[iplitntion lieap. Similarly, you can use tlie IkbugNew' libraiy 
iliat comes witli Code>K^tnior to track down memory problems 
in the built-m C/C++ memory' alkx^ater. Zone Ranger, wliich 
also comes with CotleWarrior, caii be helpful monitoring 
memory usage and watching for memory leaks. Ihere are a 
number of extensions, like five nlknterHus Error, 
1 kuibleDispose, err. ifiat are available from Apple lluit watch 
out for coiniiion programining errors when using the 
Memory Manager or Kesource Manager. Onyx 'i’eehnology 
has a tool called QC that monitors all Memory Manager calls 
and checks for these programming errtirs. A demo version of 
QC is availalile on the CodeWam'or Reference Cl ). E 

Mike Lockwood is the debugger archirect at 
Metrow^erks. He is responsible for the overall debugger 
architecture as well as debugging support for the 
Macintosh and Java. Prior to joining Metrowerks, Mike 
worked on debuggers and other development tools at 
Apple Computer. 
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SYMANTEC 
TOP TEN 


Hy Keimi Kenan 


SYMANTEC J 


This month's Top Ten 
ranges over several 
Symantec products, hut we 
begin with a couple of 
issues regarding Visual 
Page, Symantec’s new 
WYSIWYG HTML editor 


Visuill Is an excellent 

eomixinion to Visual Cafe, and a preview 
release am also he downloaded from 
<http://cafe.symantec.com/>. We follow the 
Visual Page section w'ith quest ions 
involving Cafe and its documental ion 
generator and finally we address a 
prolilem with the Visuitl Aivliitect. 

Q: I low do 1 use anchors in Visual Page? 

A: In order for the Anchor Icon to 
become enabled, your Visual Page 
document must first lx: saved to disk. 
Then, select liie text that will serve as 
the anchor, and click on the Anchor 
icon or chtK)sc* Antlior from the Insert 
menu. A small anchor marker will 
ap[xw on the left of the text that was 
selected. Double clit king the marker 
will bring up a dialog l)Ox for naming 
the anchor. A mouse click on OK 
siives the name. 


To generate a link to the newly 
created anchc^r, select the text that 
you want to serve as the colored 
link and simply drag the anchor 
marker and drop it on the selection. 
This even work.s between Visual 
Page documenus. 


Q: How do I cTeate a link to another page (as opposed to an 
anchor in another page) using Visual Page? 

Ai There are several w'ays to link to another page and the 
methtxl you use depends on where the page is and how well 
you know' the URL, If you know the URL you can .simply 
,sc‘lc<i some text and ry'jx the l‘RL in the “Link Tty" field at Uie 
bottom of Visual Page. After you preens return, die selected 
text is linked to the URL. TItere are, however, easier and more 
elegant ways to manage your links. 

To use drag-and-drop to link files, simply drag an HTML file 
from the Finder and drop it onto some selected text, Tlie 
selected text Ls now linketl to that H LMl. filt:. It is easier to 
u|KJale the structure of your links if all your HTML files are 
grouped togerhcT in a .single folder, but if you decide to 
organize your jrages in a set of nestetl folders, you must lx 


when you want to link to a page on the 
Internet, Netscape’s drag-and-drop 
capabilities make this otherwise laborious 
cut and paste operation quick and intuitive 


c'aulious when altering the struaure of your nested Iblders or 
else your links might break, 

Whvn you want tfi link to a [>age on the Internet. Netscape's 
drag-and-drop capabilities make this otherwise laborious cut 
and paste operation quick and intuitive. Using Netscape, 
navigate to a piige thai lias links you want to duplicate. Drag a 
colortx! link from tile Netscape w^idow and drop it onto some 
selected text in Visual Page. Phe selected text and tliat web 
page are now' linked. Note thai you can also drop the text fttm 
Netscape anyw'here on your Visual Page document, nol jusl on 
.selected text. In this case, Visual Page simply creates a link 
using wliiitever text kleniificxl the link in NcHscajx*. 

Q: How' <lo I eiTilxxl a Java ajiplet into my Visual Page di K umeriL^ 

A: L'or an example, we will use tlie Animation demo which ymi 
can find in the Demo Projects: Intro to Java 


PliUHDAKV 1997 • MACfiTfeCHMACAZlNh 


SvMAN'i i-t: Tom Tkn 


65 














Finish your instaiier 
in record time 
with Draglnstaii» 

You've run a long race. 

You're almost done with your product. 

Now that it's time to build your installer, 
don't let complex licensing arrangements 
and complicated tools trip you up. 



Downioad a demo of Draginstaii 

fronihttp;//viAivw.sauefs.com/dfaginstall 

Buiid your instaiier 

in Q single step with Droglnstoll's QuickScript feature 

Register Draginstail 

with a single phone call to 1-800-890-9880 

And cross the finish iine 

total time; 1 hour, total cost; $300 



For more informafioii: 

Roy Sauers Associates, 118? Moin Avenue, Suite 1B, Clifton, NJ 0?011 USA 
voice: 201*4 fox: 20L478.1513, email: tnfo@sfluefs.com 


Frogramiiiini'iAnimiiiion folder on your Cafe CD. If you 
installed the default disinhution of Cafi% then the Demo 
Projects folder will also be on your hard drive. First 
generate the .class files by selecting Build Applet Classes 
from the Build menu. Wfien the compiler is done, we can 
embed the applet in a Visual Page dcK ument. 

1) Open the Animation folder in the Finder^ you will see dial 
Cafe laas added two new files u» diis fokien Animation.class 
and Animator class* 

2) Bring your Visual Page document to the front so that you 
can still see the icons for the new .class files, 

3) Drag the Animation.class file onto your Visual Page 
doeumeni and drop it wherever you ]dease, A dotted box 
appears with a picture of Duke waving and the label 
Animationxlass. 

4) Double click on the picture of Duke anti a dialog box 
ajijxrars allowing yoii to set the Applets punuiieters. 


You can now explore the Java API in the 
comfort of your own web browser. 


5) Change lK)ih the Witlth and Height to and click OK. 

6) Save your Visual Page d<K:umeni and you are ready to 
view yf)ur new\ applet-enhanced wel) page in any Java 
aware brf>w.ser 

7) ChcK)se Brow'se in the Falii menu to ofxm your Visual Page 
drxiiment in a w'eh browser. You may first naxl to tell Visual 
Page where ymir brewser is by selecting Preferenexfs*.. in the 
Pdit menu and clicking im the bitjw^ser icon. 

We dragged Animation.class ratlicr than Animaior.das.s onto 
the Visual Page window because \he Animation class 
extends the Applet class* In genenil, always drop the .class 
file that extends tlie Ap|)Ict cIuns, 

Q: Does Cafe inipleineru java's documenration generator!' 

A: Ye.s. In fan, incluckxl in your Cife disiiibuiion y<Hi will find 
HTML documcrUaiion of the entire Java API. They are 
loc'ated at Symantec Cafe for Macintosh;(Java Libraries):*A]^l 
Documentation. Dcnible click on the packages,in ml file to 
0[x;n it in NcLsciipe* Ytm can now explore tJie Java API in 
the comfort of your own wel> browser, integrating the 
documentation for your own classe.s init> this collection 
simj)le reejuires a menu .selection. 

1) Open a project window — die Animation projtxt we u.sed in 
Ltic previous Areswer works just fine, 

2) Select a *java .source file. 
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Distribute Your Software 
Electronically and Get Paid! 


PACE Software authorization systems let you: 

• Create fully fiinctional time- or launch-limited "trialware” 
without changing your source code 

• Distribute via the Internet, CD-ROM, BBS, floppies and more 

• Unlock software with flexibility and security 

• Add registration-capture to your software without writing code 

• Integrate registration and authorization with popular web servers 



PAGE 


ANTI-PIRJtCV 


To sample the customer experience, download our 
demo from www.paceap.com. It's easy, and it's free! 

Want to try out our system on your software? Call 408/297-7444 
or send email to salcs@paceap.com to order our evaluation kit. 


1082 Glen Echo Ave 

San Jose, CA 95125 
vox: (408) 297 7444 
fax: (408) 297*7441 
email: info(^paceap.com 
web: wvvw.paceap.com 


3) Chooser Produce Documentation from tlie Build menu. 

After a few seconds a dexumentation file for eacli class in die 
.java source will appear in ihe API Dcx.'tiincntaiion folder. If you 
used the Animation project, dien two new files, AnimationJitml 
and Aniinator.honl, were produced. Generating dtKumenLaiion 
for an entire projea is simple as well. 

4) Bring you project's wtndt>w to the front. ^ 

5) Selea Generate Air Documentation from the V menu. 

A dialog box will ask you lo confirm your desire to produce 
the dcx'umentation; press OK and off you go. 

Q: I followed tlie alx>ve directions with the Animation project, 
but no documentation was pnxlueed. Why? 

A: The documentation files were most likely produced, but 
placed in a different folder. You can specify where a project's 
documentation is prtxlueed by selecting Options,,, from the 
Project menu. In the window tliat opens click on the Project 
Type icon in the left column. You can now set the 
DrK'umentati(jn directory as you choose. Factory Settings 
direct die documentation to the Al^l Documentation folder. 


Q: I set the Options so that my project's documentation is 
produced in the project file, l>aL now when I browse the 
H'lTVIl. Rles in NeLscafx: the graphics do not appear and links 
to odicr java classes are broken. 

A: 'llic project manager expc'CLs all documentation fiJes to he 
togetlier in one folder tliough you can specify whii;h folder. A 
good strategy for keeping all yonr documentation in a single 
folder while remining acces.s to ilicni from your pK)ject file 
recjiiires you Lo fiisi generate the documentation in the project 
folder Then make aliases of the files, and move die originals 
to the Al^l Dtxru mental ion folder or wliatever folder you have 
specified for your dcKumentation. Now when you double 
click on one of the aliases* Netscape opens the (mginal and 
the graphics and links W(jrk. 

Q: I like having the documentation produced in my project 
folder but I would rather not reset tlie options for each new 
proje<i. Is there a way to lell llie project manager to always 
.set die appmpriate options whenever 1 create a new applet^ 
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A: Mom doHotk^ly. in.skie Symantec Cafe for Macmto,shi(Prt>jLx:l 
ModeLshJava Applci yoo will find a project file called @L 
Open this projea by dragging it onto Cafe's pniject manager. 
Set the options for this project as you wish and close the 
project. Every new applet you create will inherit those 
options. You can even go s<> far as inc:kiding a fofcler iastde 
the Java Applet folder and set the options to always pnxluce 
the d(x:umenialion in that folder. 

Q: When 1 Lise the Class nrow,ser in Cafe, and double t lit*k on an 


The Class Browser tells your web browser to 
look bi whatever folder you have specifled 
for documentation. If you are producing 
documentation in your project file, the web 
browser will not find the java classes 


italicized class name, I ger an error of -43; I wouk! rather get a 
description of tlie class. 

A; An iuilit:ized class name jneaas that the java source for ihat 
class in unavailable Ibr ihe Cla.ss Browser lo read. In.stead, 
you can set up InternetConfig (included in the 1htrd Party 
GfKHiies fokler on you CD) to point to your wd> browser. 
Then, wlien you double click the class name your web 
browser opens to dtsf>lay the HTML documentation as 
described earlier. An iniponant detail lo keep in mind, 
though, is that the Class Braw.ser tells your web browser lo 
look in whatever folder you have specified for 
dtKumemation. If yfxi are producing docu menial ion in your 
f)rojecl file, the web hrow.scT wall not fiiul the java classes, 

Q: I am experimenting svith packages by putting the above 
Animation projeci into a ]>ackage called 
myJava_ela.sscs.niy_aniniaiion. Ikit wlien I try to generate the 
documentation all 1 get is the ffTML llle ftir the Animator chiss. 
Wliat happened to the dcKumenuiiion for the Animation class? 

A: D(XTjnienlation files are named after the hill package name, 
and when your package name is prepended to the class 
names, you end up with a file name longer than the 
MacInioslTs maximum of 3^ characters. The overflow 
chameters are simply cut off and in this case the resulting 
names are kientictiL lioth dcKumentation files are prcxlucecl, 
but ilie last one prcxluced overwrites the first. To resolve tliis, 
use shorter package name's. 


Qi Visual Architect v8.1 ikyes not seem to create a floaLing pallet 
with the drag hir on the side milier than the top. Wliy noL^ 

A: Visual Arcliiteci v8.1 apparently generates a faulty WDFF for 
fit rating pallets. A resource internal to VA Is used lo generate 
the ^T)EF, and tlie solulitin retpiires lls to replace this internal 
faulty resource, 

1) Retrieve the Infinity Wintlokl WDKF 2.6 ctxle resource from 
<gopher://micrGS.hensa.3C,uk:70/40/micfOS/mac/finder//m/m036/>. 
The file you want i.s called in()36innn.hc|x. Nelstape can easily 
do tills; simply paste the alxwe URL into the ""Go To:" field 
and press return. 

2) Lise KesEdit to ofien the ResEdit file Infinity Windoid 2.6. 

3) Double click on the WDEF resource that appears in the 
Infinity Windoid 2.6 window. 

4) From the Edit menu, dux isc* Gipy. 

5) Make sure tlie Visual Architecl a|>plicaiion is noi ninning, and 
o(x:n it willt ResFdit. 

6) Find the WDEF resfRiree vvilhin ResKtlit's Visual Architect 
w^indow. Open tlie resource by double clicking it.s icon. 

7) Seled the resource numix^axl 2(H) atid duxise Clear from the 
I^dil menu. 

8) Now chtxjse Paste fioiii llie Fxfil menu. A resource' with the 
name 'Infinity^ Windnid 2.6” slunild ap|K'ar. 

9) Make sure this new resource Is selected and choose Gel 
Resource Info Itoit) the Resource menu. 

KDChange the ID field to 2fHl and un-check “Purgeable.” 

inclose the ResEdit windows and .save the changes when 
(irompiied. Visual Architea is now ready for use. 

Special thanks to Mark Baldwin, 'fed Plug, Richard Hill, 

MaUhcAV Hopkins, Steve Howard, Scott Mtxlson, Kevin Quah, 

and Steve Wtilf for their coniriburions fn this article. B 


Want to share a tip with the 
community and get paid for it? 
Send it in to 

<mailto:tips@mactech.com> 
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Shall we play a game? 


SiAKiiNG Points 

11 intLTcsiLxl iii U>uring the online world of Mac'tnitxsli 

game progniinming, to get started 1 reeoniiiiend pulling in to 
^^can M. McDowell’s Hilsttjp. .Sean's Mac Game Programmers' 
Hitsn^p provides link.s to tile latest news and some of the most 
essential sites for Mac game progmtTiming. 

Mac Game Prognimmer liitstop 

<http://www.undefgrad.math. uwaterlooxa/-'Snnnicdowe/Bjtstop.html> 

SPHH EWoRLD, tut SlZQLTEL 

Docs your program use animaUon? If so, you probably 
know about Tony Myle\s SprileWorld, r>ne of ihe iiiost 
l^roininent Macintosh freeware libraries for generating sprite 
animation's. However, you might not have heard about 
SpriteWorld 2.0. This is the latest major release of 
Sprite World brought to us by Karl Hunker 
<maitlo:KaflBunker@aoLcom> and Vern Jensen 
<mailtC3:Vern_Jensen@lamg.c(3m>. SpriteWorld 2.0 introduces 
new routines that allow you to scroll a large background 
across your window^ withtmt having lo create a huge 
GWorld. Imagine what your alxiui box could hx'ik like if yon 
m:uk‘ use of Nintendo quality scrolling backgrounds.., 

Version 2.U i\lm introduces new “tiling" niuiines, wJiich allow' 
yrxi to kiyer sprites .so tliat a ckjser one |xasses in front d another 
sprite. With iJiis relc^ase, SprileWoHd even lias it's own wttb site (Fni 
proud to tell you I was visitor ^00000009.) Check out the 
SpriteWorld pages for dcK'umtmtaiion. to download the libraries 
and Sf3urce cxxle, or just to check out si>me very impressive tlemixs. 
Sprite World 2.0 Paiges 
<http://users.aol.conn/spritewld2/> 

FiNDiNCi Answers 

The best re.source a starting programmer can have is a 
good book. T'w() of the most jxipular reference books for 
Macintosh game programmers are Black Art of Mat intosli 
Game Programming and 'Iricks of the Mac Game Programming 
Gurus . To help folks get an idea of what each of these books 
has to offer the publishers have put brief descriptions of the 
lxK)ks < inline. 

Matthew Xavier Mora Is just beginning to build the 
"comp.sys.mac.games. programming-book" pages — an H'lMk 
format book that will act as a tutorial for Maciniosh game 
[)rogramjiiirig. A more complete formal Mac game 


programming FAQ maintained by Joshua Grass Is called the 
Macintosh Game Programming Workshop. 

Conip.sys.mac.games.programiner is the Usenet forum 
dediaited to Maeintosli game [mjgramtningj and the place to l(x>k 
for the comp.sys.mac.programiner.games FAQ — rnairiLiined by 
Kyle Ellrolt. Re€.ganies.progmmrner and coiiip.grapliics.algoritlims 
are also useful resources, and folks can subscribe to Apple's 
Maeintosli Gaines Dcveio]'>er mailing list by sending email to 
<listproc@solutions.apple.com> with "SUl^SCRIBE mac-games-dev 
<your rmjne>" in the Ixidy, 

Black Art of Maciniosh Game Programming Page 

<http://vvvm.mcpxonn/waite/wa[tG/books.new/Black_Arl_Mac_Game_ 

Program/htm!/bamgpcovhtml> 

Tricks tif the Mac Game Programming Gurus Page 
<http://www.mcp.cam/haydGn/mac_game-guru5/> 

Com p.sys.niac.games.programming. book 

<http://www.best.com/'-mxmora/c.s.m.g.p.b.0.html> 

Maciruitsh (ianie Programming Workshop 
<http://anytime.cs.umass.edLji/--jgrass/M6PW/inde?Lhtml> 

The Best of Aij. Wt>RU)s 

Some will teli you that the Mac can be all ihing.s to all 
people — including a Nintendo system for those of us addicted 
to Mortal Korn bat. If you doubt them, check out Jolin vSdle.s 
Macinio.sh emulators page. John lists twenty tlve fdatfoniLS tliat 
can Ix" emulated with a MacinKisii -- everyiliing from an Atari 
2600 to a XX Spectrum. Each of these links takes you to a 
summary page describing what emulation programs are 
available, listing important intdrmaiion, and providing links to 
i^lated sites. For example, ihe Apple li page begins with a link 
to an Apple 11 emulation FAQ; it compares the Features and 
sLabilily of two Apple He emulalors; provides links for 
downloading 68k and PI^C versions of Apple IK, Apple He, and 
Apple ligs emulators; and wraps up with links to Apple H 
software archives. 

It is comforting to know thai our favorite platform can 
generate a w^orking envinmmetU for testing Magic Cap utilities, a 
playgrtnmd for enjoying our favorite Game Boy programs, or 
even a shell for using 'I'l-HI or HIM8 calculator packages. 
I lowever, it can n\m provide us widi a link to the past, allowing 
iLS to rememlxr our first experience with a 'I’RS-BH, Commodore 
64, or an ;mcient environment uilled "Windows." 

Macintosh Emulators Page 
<hTtp://www.cs,csobak.edu/-jstiles/emu!ator/> ID 
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CoNTX Graphics announces OpenGL for the Macintosh 

Conix Gniphics announced the release of OpenGL version 1 
for the Macintosh. OpenGL assisis graphics developers in CAD, 
Mechanical implementation, Architectural Design, Medical and 
Scientific tmaging, Geophysical Sciences. Animation, 
Photorealism, Data Visuali/ation, and Simulation. 

OpenGL is the premier 2D and 3D graphics library that 
allows developers to build geometric models, view models 
interactively in 3D space, i:ontrol color and lighting, manipulate 
pixels, and perform such tasks as alpha blending, anti-aliasing, 
depth cueing and texture mapping. 

Early bcnchttiark testing shows that OpenGL for the 
Macintosh out perfomis OpcnGI. offered by Microsoft and IBM. 

Cross platform capability enal>ies programmers the 
ricxibiliiy to transition code easily and smoothly from one 
platfonii to ^motlicL 

<!)penGL for the Macintosh by Conix also supports C, ADA, 
and FORTRAN. Integration with Tenon's MadiTcn UNIX and 
Hardware acceleraiion through RAVE (Rendering Abstract 
Virtual Engine) will lx: available first quarter of 1997. 
<http://www.conix3d.com> 

PKZIP Sui'KiKi TO Pt>WER Mac: 

Developers are able to incorporate VKYJP implode and 
explode capabilities into their programming. 71ie PKZIP DCL 
provides a library of routines for the compression and 
decompression of data on a Mat intash or Power Macintosh. It 
allt)ws programmers to compress and dc€ompres.s data using 
their own file fKindling routines to read and write their data. 

Other features indude: an all purpose, patented data 
compres.sion algorithm that compresses lH>Lh ASCII and binary' 
data tjuickly, application controlled input/ouiput and ntemory 
allocation for die utmost flexibility, and adjustable dictionary' 
size that allows tlie software U) be fine tuned for maximum 
sfK'ed or compre.ssion. 

ASi LS tlic gldral leader in compression solulioas. 'Hieir line of 
compression utilities includes sodi names as PKZIP. MuliiZip, 
NeiS(jueezt:, ami Nicti Mak Ctmipuling Inc.'s WinZip, and supports 
AS/^00. IX)S. Mat:intosh. MVS, NetWare. OS/2. UNIX. VMS. VSE. 
and Windows plalfontis. 

<http://www.asizip.com> 

MathSoft Ships Mai hcad Plus 6 for the Macintosh 

MathSoft, Inc. announces shipment of Mathcad Plus 6 for 
the Macintosh. An advanced version of the Mathcad technical 
calculation software package that offers a wide range of new 
features making it even easier to use for Macintosh aistomers. 


In addition to iLs technical takiilatton c'apabiliiies. Mathcad 
Plus 6 for die Macintosh now features Ixiilt-in Internet t:onne<tivity 
tliat will tx:nefit users in the technical and academic markets 

Mat heads distinctive Utfe document interface lets users 
integrate text, calculations and graphs, then document and 
share results in an easy-to-use environnient. Maihcad Plus 6 also 
allows users to link and hyperlink worksheets over corporate 
intranets, WWW or Itjcal web servers for applications such as 
workgroup sharing in a corporate or sdentific environment and 
distance learning in eduration. 

While Mathcad Id us 6 for the Macintn.sh includes all the 
tVatures of Mathatd Plus for Windows, and is conifxilible with the 
Windows version, the new product also includes .several new 
features including: improved editing and formatting capabilities; 
simpler menu structures; the ability lo create and embed 
animation within a worksheet; and QuickPka. a new inleiligenl 
formatting cafxibility allowing easy, direct graphing of formulas 
and expressions. The software, clesignetl for the PowerMac, also 
provides support fc)r (38030- and 68040-hased systems. 
<http://www.nnathso1t.conn> 

Claris Corporation Expands Claris Solutions Alliance 
Claris Corpt>ration announces the expansion of the Claris 
Solutions Alliance (CSA). a consortium of software 
professionals, publishers, authors and trainers who use and 
reccunmend Claris software products, Spurred by the fast 
growili of the CSA, which ha.s risen to nearly 1.500 members 
wxirldwide, Claris Is adding two new tiers lo the organization. 

Claris Partners, a new CSA membership, is for highly 
ex[)ericnced software development professionals wltu will work 
closely with lx>th Claris Corporation prcxiiict developmeni and 
sales teams to better address the needs of Claris .softw^are 
eiisiomers, in addition to access to beta versions of Claris 
software, direct ledmiciil support, special siiles incentives, and 
numerous co-marketing opportunities^ Claris Partner CSA 
meniliers will undergo reference veiificaiion and annual testing 
by Claris and will ret'cive an official Claris Partner logo for use 
within ail promotional niaierials. 

CSA Enterprise memix'rship. another new- ('aregory of CSA 
niemlx:rship. Is designed for a wide variety of professionals within 
businesses and corporations who are responsible for in-house 
(.litabase developmeni, administraLion of FileMaker Pro databases, 
and help desk personnel supporting FileMaker Pn> u.sen>. 

CSA Associate membership, formerly known as the single 
CSA membership, has Ixx'n expanded to a include wide scope 
of users, including software consullanLs. publishers, traineoi and 
the novice developer/consulfant. 
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Ciuris S<>lutions Alliiince was fVnJndecl in ]99i. Uisl June, 
Claris sponsored the organi?:ation's Rrsi worldwide developer's 
conference held in SaoUi Clara, Gilif. The CsSA plans to hold its 
seccind annual conference this Spring in the San Fnint^iscro Bay 
area. Further details on the 1997 CSA Worldwide Developer's 
Conference wall be provided ai laicr liriie. 

<www.clahs.com> 

S-CASII Now Supports UML 0*91 

MultiQuest announces die release of S-CASF 3 0 (rev. 1.9) 
with enhanced support for Unified Modeling Dtngtiage 0.91. 
This new version reaffirins MultiQuesTs coriiniitiuerit to the UML 
notation profxxsed by renowned olijeci-t^riented niethcxlologisLs 
Grady B(Kxh, [varjacahson and Jim Rumhaugh. 

S-CASE 3.0 was designed from ground up u> provide the 
true UML metamodel as its foundation. Tins metantcKlel Is fully 
accessible using Tc! .scripls, thus providing hooks for code 
generators, report writers and other useful tools. Additional 
enhancements in this new version include improved code 
generation and reverse engineering. 

<http://www. multiquest .co m> 

Claris IIomi Pagi 2*0 Now Avajiabij^ for MAr:Os and 
Windows 95/NT 

Claris Corporation announces the availalulity of Claris 


Home Page 2.0, the next version of the cimipany’s popular 
web-authoring software for MacOS and Windows 95/NT users. 

Claris Honie Page 2.0, designed for novice-to-expcn. web 
page authors, is the essential WYSIWYG, web-authoring 
solution that provides the ability to design and develop 
powerful, cusLoniized web pages in minute-s — wiihoui having 
to Icam HTML or programming. 

Claris Home Page 2.0 al.st> delivers alJ die capabilities and 
tools web masters need — frames, tables, libraries, mu Irimedia 
f)lug-in .sup|>oii, built-in remote site publishing, ihe ability tt> edit 
raw HTML, and more. Also, in a i:ros.s-pladbnii solution that 
provides incredil>le ease of use as well as the Bexibility and 
power that exjx:rienccxl users want. 

Claris Home Page 2.0 delivers impcirtani new capabilitie.s 
and features designed to enhanee Ixnh the Icxik of web pages 
and tlie productivity of well authors. 

A new feitture that novice users will especially afitirceiate are 
tile 23 site tempUtes providccl tor tlic‘ tieation of a |iersonal page, 
calendar, newsIcLler, presentation, or .small business pre.senee. 
Tfiesc easy-toHJse tempbtes increase prrxluttivity, offering jnultiple 
style varuitioas for a loiiil of ulmf>st 100 individual pages, 

Other new features include built-in remote site publishing, 
with auio-consolidation of files and one-step uploading to a 
designated server; suppfirt for popular multimedia plug-in.s, 
including QuickTime, Java and SlKX’kwave; s|>ell checking and 



We’ve Got the 
Right Tools 
For Your 
Web Site! 


And our skills are pretty sharp, too* 

We can trim your content, hone your design, and 
implement a Web site that's ***well**. a cut above the rest 

With today's chopped budgets and pared-down schedules, you 
need JointSolutions Marketing. We have the experience, and the tools, 
to make sure your World Wide Web pages aren't.*,you know,*,dull* 
We even have a Web server, so site maintenance and updates 
don't slice into your work time. 

Cali us today and we'll take a whack at your Web needs. 


JOINT S JointSdudoris Marketing 
|E Td: (406) 471-1500 
1 0 E-mail: info@jointso I utions. com 
5 http://wvm.j o i ntsol uti o ns.com 
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supp(.)rT for multiple fonts within web pages via the PONTMCE 
tag; client-si tie, as well as server-skie, image mafxs for easy 
linking to other pages and sites; and HTML editing 
enhancements such as syntax coloring. 

Claris Home Page 2.0 users will also be alile to dynamiolly 
re-size and reposititm frames by pointing and dragging with 
their mouse; preview Ixtckground GIF images from w'lrhin Claris 
Home Page; drag and drop talxlelimited text from spreadsheet 
and daLafjase documents tt) aiitomaticaUy create tables widiin 
their web page; and specify row heights and column widths 
within tables by typing values or dragging cell ixirders. 

Version 2.0 provide.s concurrency or “sclcclit^n [ireservation'' 
Ixlween and HTML modes, alUjwtng users to go Uj 

the prtxise location they w^ea* working in tlie previous mode. 

Claris Home Page for MacOS requires a Macinitwih, Ptjwer 
Macintosh, or compatible comptiter with a ()8020 processor or 
higher; 8 MB memory; System 7.1 or later; and 2MB free for 
ininimum installation (6MB for full installalion). 

For Windows users, Claris Home Page RX|uires an Intel 486 or 
higher compatible PC System; Windows 95 or Windows NV 33.1 or 
newer; 8MB PAM (l6 MIJ for NT); and 4 MB fiee iutrd disk spac^. 
<http://www.daris.com> 

Lasso LI 

Blue Work! Communications, Ine. announces the release 
of Lasstj 1.1, advanced tool for integraling Claris 
Corpora!ion'.s FileMaker Pro 3 0 for .Macintosh databases 
with the web .server 

Laxso is designed for fast performance, Seaahing FileMaker 


Pro Macintosh relational tlatapKises with tens of thousands of 
records in under a sec'ond is now |xxs,si[)le with Htsso. 

Ltsso operates by recognizing special commands placed 
in standard HTML fries, i'hese commands define all 
interaction between FiieMaker Pro and a Mac08 weh server. 
Lasso functions as the “glue” lietwecn FileMaker Pro and the 
web. Lasso HTML files (or formal files) are easily edited in 
HTML authoring prtjgrarns such as Claris Home Page with 
drag-and-drop control of data using the supplied FM Link 
tool. Template files are provided for selling up web 
databases in minutes. 

Lasso allow.s complete llexifiility in how FileMaker Pro 
data is formatted without requiring any clianges to the aetual 
database. Lasso faciliiaies remote administration of web 
database configurations from anywhere on the internet. 
Lasso also provides routines for security, thus allowing 
greater control over how databases are served and 
administered in sfiared environments^ 

i.asso offers many features including support for 
rclalkm.s/pf>rtals, repeating Helds, dynamic population of value 
lists, built-in email lorvvardtng, If... Else.,, conditional 
statements, built-in reinoiely configured security and more. 

Version LI adds suj-jpt^it fcjr serving images directly from 
I’ileMaker Pro, passing K^kens (critical for user tracking schemes 
such as online slujpping carts), ScriptMaker scripts, dynamic 
control of Li.ser and brow.ser inlorination, field and record level 
security, ope]riti[]n as a WebSTAR plug-in and [)rovides enhanced 
capabilities tlirougliout Lisso s core Features. 

<htTp://www.blueworldxom/lasso/> Mi 



I 


The fastest, cost effective way to get product off your shelves. 

For information: • Voice: 805/494-9797 • Fax: 805/494-9798 • E-mail: marketing@deydepot.com 


72 


Ntw.sBns 


MAlfFRCIliVL\GAZtNr * Fkbruary 1997 














TIPS & 
TIDBITS 


By Slwe Sviak 



I ho|x^ \lm sur|)rise.s at legist some readers and helps avoid a 
hug or two. Here's a self-test to see what you know aijoul 
sLihtraetion. he honest. 

On a P?C chip, which of the following sets the carry hit 
(as^suniing an instmction Ibrni that sets the carry is used)? 

a) 0 - 0 

h)0-1 

On a 68K chip, whir'h sets tlie ciny? 

c) o-a 

d) 0 -1 


FPC: cany is .set only it tlie sruirce w:is negative and ANY ones 
arc shUted out of the right. 

Yes, it's ail in die manuals, but who rcads manuals? 

<bitlKarsh@aoL€om> 

1) When patching a lihraray, _Open needs more paratn block 
fields cleared than d<x"s _OpcnDF. 

2) when changing die font of a (popup) menu by hcxiking the 
MDfiF, bistSPExtra mtust Ix" set to - I to t^leiir the font cxidie lx all 
before calling the MDFF anti after resumiig tlie font stuff. 


Did you answer (a) and Cd)? 'Ihitfs right. Subractitjn is defined 
differently on PPC than on 68K, which might catch you off 
guard, especially if you're an old hand at 68K asm. 

On ()8K. sub d(),dl defined as dl = dl - dO, and the c:iirry 
behaves like a simple btHTow. However, Pl^C makc-s direct use of 
the definition -n = NOT(n) + 1 and, •'>niif r5,r3.r4 is defined as r5 = 
ri -r NO'IV3) + 1, making the XFR[CA! bit (for iastnictions that 
Li|xiate it) reflect an addition carry instead of a Ixjrrow. 

'I'his difference propagates to extended subtraction. You 
would do extended sulitracticm similarly on either chip. 

68K: 

t) sul) km^ words. 

2) subx liigli words. 

P1>C: 

1) subtc kjw' words. 

2) subfe liiglt words. 

However, the inttrrnal details are dil'fcrent. 

subx dO,d 1 -> dl = dl * dO - X bit. 

subfe r5ir3tr4 -> r5 = r4 + NOT(r3) + XERfCAl. 

There are many other examples where the carry works 
completely differently m the two chips (e.g., aritiimetic rigljt-sliifis). 

68K: cany Ls set (for any type of source) if and only if the 1 AST 
bit shifted exa of the riglit wa.s a one. 


Tony hkfhm 
<ronyn@ti3cnet> 

liaving trouble getting Apple Menu Options' hierarc hir'al 
menus to show? You may nor have callal MaxApplZtjneO c^iriy in 
your appHcati{)n. The various patcfies AMO installs require 
suffic:ient heap to draw' tlie menus; if you dt)n't expand your heap 
to its maximum eady on, the putche.s may ntji have the right 
amount of memory available when first called, and your 
hienm:hk:al Apple menu will nut draw'. 

Biian Bcchlei 
<blob@dpplexom> 

Apf>lc's System 7.5.3 (aka System 7.5 IJpcbte 2.0) adtis a slick 
new way to quickly get iiiountl while in a StandardFilc diaktg. VCIiOe 
the dblog Is up, dick on lire desktop tir any folder t>pen on ytxtr 
desktop Ytxi did na receive tlie annoying lxx;p you expected as in 
7.5.1 and earlier — instead, StaodarrlFile took you right to that 
direaoiy! 'Jlijs is invaluable when you luive yextr deeply-nested work 
folder opened on ilic desktop and Standardl'ile decides to stick ycxi 
in scxrie remote loc'^ation. Now anything visible is one dick away! If 
Apple w^ould give us the new moval>ie iiKxlal Hie duikDgs, we could 
really take advantage of tliis. Tliese arc coming in Copland, but I am 
Ixjpmg tliey will appear in System 7.6 that his OpenDrx' liuilt-in. 

Bill Hayden 
<maSto:nM@codewellwm> 

m 


^etul us your ti^is 


or well install EvenBetierBusError (M your fnachimf On the other hand, we might just pay you S25for each tip we i4se, or $$0 


for T^qf the Month ^ You can take your award bigootk, sulmripHons or US$. Make sure any cmh compUm, and send Ups (and where to mail 
yoirrwimiings}Uhmr Tips e-nmit address aHips^macieckxmi i^^pagi\2for tni^otb^aM ? ^ . 
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TOOLS OF THE 
TRADE 


By HdwarJ Hingel 



Macintosh Programming FAQs 


Lots of informalion 
m a good package 


NtiiDi-D: A Guide for the Perpij^fd 
Reculling my undergmduuie course in 
organic chemistry^ my lextbook weni 
ihrougli a r^iilier lengthy description of a 
synthesis. I would read il and I would think 
1 LindcrsttXKi it. I’d then go on to llte next 
page, and an equally daunting process 
would lx* Icl'l as "‘an exenise for the reader,” 
implying that at this fx?int the logic sitouid 
he pretty straightforward and any dummy 
should lx able to figure it out. It would be 
at this point that I would rcali?,e that 1 
wasn't as sm;irt as 1 tlioirght. 

So it is with Mac pmgmmming. llx ftna 
time I trietl to [Xii a ILsi in a dialog I tunefully 
read rhrougit laside M;tciniosli. Volume IV, 
anti I tTiished and burned when tlxy started 
talking about event filter procedures and 
drawing prtxedures, with implemeniaiion 
left iLs an exercise for die progrttmmen 

Things arc different from 1986 and 
1987, when the List Manager was young, 
and System 3.2/Finder S,3 wats new and 
exciting. There are numerous hof>ks and 
gcMxl examples of introductory’ technique.s. 
'Hiere are very gcx>d guides to the [iroper 
coasmicrion of a Mac GUI, using standard 
design elanenLs. Apple has improved its 
sample code considerably, and 1 would 


argue that it is fairly easy to get starred if you are willing to 
spend the time. 

'Fhe road gets rockier when wc get tlie next level of 
.soplusiic^aiion. How do you customixe a irienu? How do you get 
the Notification Manager to notify the user? How do you add 
the little things that make a program special and professional? 
Cenainly, there is an xicaimulated lore and body of experience 
which is availatde on the Internet, in various college and 
university repositories, the Apprentice CD series, and even from 
Apple. However, the information is diffuse, often poorly 
documented, and highly variable in quality and content. For the 
^every man" mainstream programmer, the person using an 
unmodified Mad leader straight froiti Meinjwerks or Symamec, 
hootstmpping to the next level of sopliisticaiion can involve an 
unreasonably steep learning curve. 

Enter Mac Progilamming FAQs 

Mac Programming FAQs, by Stephen liakcr with Dave 
Mark, is this needed organized repo.sitory of more advanced 
programming technique.s. It Is a wonderful lKX)k. It t:onsists of a 
600 plus page book plus a CD (wx'll get !>ack to the CD 
contents in a bit.) After an introdudion, the hook consists of 
650 frequently asked questions alx>ut Mat:into.sh programming, 
each answered concisely and usually illustrated wiUi cxxle. 

1 enjoyed this [xx)k for several reasons. First, it is simply 
well written. Baker and Mark are a g<Kxl team, and they used a 
terse, but easy to read style. There was little ambiguity in the 
pre.sentation, but at the same time it was not technical or 
handbook-]ike; the informalion flowed freely from the page. 
Second, it is written in a smgle voice; tlic approat:h is that of 
one individual, and it is easy to .stay tuned to die presentation. 
Third, the informalion was ac’curate. While there were a few' 
typos and mis-statements, there were very few errors of fact. 
Kouffh, this book is a gold mine of information. I le-arned a 


Ed Kingei is the Contributing Editor for product r-eviews for MacTeeb Magazine. In his spare time, he Ls a respiratory and 
critical care doctor in Waren'ilb, Maine, He can lx reached at erjngeliimint.net. 
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licck of a lot of new stuff, and got a bunch of questions on 
some murky topics (for me, at least) answered concisely. 

The book purports to address the needs of a wide spectrum 
of programming skill. Wliilc a few of the questions are those 
posed at the beginner level, the bulk of the book addresses 
advanced and intermediate programming techniques. 1 saspect 
that a beginning programmer wlio tried to attack this book 
would certainly get something out of it, but the experience 
would be akin to learning to swim at the deep end of the pool. 

Topics 

This book covers questions about mainstream programming, 
it does not cover networking issues, writing PCI card drivers, 
maximizing efficiency of QuickDraw GX printer drivers, etc. It 
does cover events, dialogs, lists, menus, printing, notification, 
windows, resources and the like. The book is organized along 
the lines of the various Managers. Typical questions include: 

‘'How do 1 get the full path of a file referenced by a 
vRefNum, parent direaory ID, and filename?” (File Manager.) 

“How do 1 attach an icon to an application?” (Finder and 
Desktop.) 

ilow do 1 change tlie title of a menu in the menu bar after 
it has been installed^” (Menus,) 

“Why can’t I access QuickDraw globals like UhePorF 
anymore?” (QuickDraw: Drawing.) 

“Given a handle to a resource, how can 1 determine whicl:i 
resource file it came from?” (Resources.) 

“How da I draw dimmed (grayed out) texL^” (Text: Fonts 
and Drawling,) 

“How do I put a li.st in a Macintosh model dialog box?” 
(lists and the List Manager.) 

Some only take a line or two of text to answer. Others, 
such as the list question, took three or four pages, in general, 1 
liad a pretty good idea of how to do .somerhing once I had read 
tlie answer to the question. Questions are cross-referenced, witli 
respect both to specific FAQs and other more general topics. 
7'he only serious critk'ism I have of this book is that it tries to 
address the Apple Event issue. 1 liave found this to be one of 
tlie most difficult areas of mainstream Macintosh programming, 
and it seems almost silly to have a few pages of FAQs about this 
incredibly complex Manager. Fortunately, the authors have die 
sense to direct the reader to more appropriate, in-depth 
resources, and acknowledge the limited scope of coverage in 
the book. 

Code 

The great majority of article.s include some ccxle, even if it 
just shows how ttj cal) a T(x)ltx)x funclitrn. Tlie code varies from 
a snippet to a short program, but in my experience it a) always 
illustrated the point and b) worked when ran. Examples tended 
to be simple enough to follow, hut complex enough not to be 
trivial and to illustrate the demonstration points successfully. 


Baker and Mark resisted die temptation to throw in tricks and to 
hot dogi 1 think Apple would approve of |ust aboin every 
technique demonstniLed. All coding and examples are in ANSI C. 
There is a short series of FAQs aix>ut Pasai) versus C, which was 
the only deparaire from this observation, 

A CD Too! 

The CD has three components. First, it contains complete 
projects (Caxie Warrior) for the longer examples. Tins means 
source, project file, and resource, as well as a compiled 
executable. Second, snippets are contained within Simple Text 
files for use in any environment. Third, there is a searchable 
databa,se thai includes every ([uestion asked in ific book, witli 
its answer, similarly cross referenced. As 1 said above, 1 
experimented extensively with the code, compiled and ran as 
advertised; the qualiiy assurance on this material was very 
gocxl. The database worked well and delivered as promised. If 
you like working from the screen and using a search engine 
better than using a htK>k and an index, you 11 be very happy 
with die database. 

Can I Ask for Better? 

Not really. Frankly, I think this is the best forty l>ucLs Fve 
spent in a long time, I feel as though I have the resources to 
make my programs more professional in appearance, and I will 
waste less time in future projects, indeed, I suspect that it is 
people such as myself, the serious Ilolibyisi/intermediate level 
programmer who will find this book the most valuable, 
precisely for tlie reasons 1 just stated. Enjoy! 

Mac Programming FAQs, liy Stepficn H. Baker wiLli Dave 
Mark. IDG B<K)ks, Foster City, CA. Co[iyright 1996. ISBN 0-7645- 
4001-7. List price $39.95. M 


Want to know what 
products are available 
for MacOS 

development? Check out 
Developer Depot™ 

<http://www.devdepotxom> 
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Think of it as your source of news and announcements in the 
MacOS developer community. Loaded with up to the latest news, 
and constantly updated with developments in our industiy. 

MacTech NOW " brings you up to speed on everything you need to 
know — instantly! And thanks to our new “fast-download” design, 
you’ll get to the information you want in seconds. 

Give it a spin! Check it out today and get access to over 1500 pages 
loaded with news, tips, programming secrets, product reviews, and 
much more. And for those of you looking for some kicks, there’s the 
ever popular “Programmer’s Challenge” section where you’ll get to 
bang heads with the best in the conununity. 

Log on to MacTech NOW. Things are happening right now, and you 
should be aware of them. 
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• Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 

• Phone: 1-800-MACDEV-l (Outside the U.S. & Canada: 805-494-9797} 

• Fax: 805-494-9798 



✓ Hundreds of 

developer products 

/ Satisfaction 
and iowest price 
guaranteed 

/ Worid renowned 
customer service 

/ Order by phone, 
E-maii, fax or 
through our 
continually 
updated 
Website 


NOW CARRYING 
APPLE PRODUCTS! 

see pages 3>4 


























Hours 


.V.and all day too. In fact^ir 
Web site is open 2-4 hbur^l. a 
clay. 365 days a veai! 
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in developer lools. we're j|fst a 
couple ol keysirokes away. 


You can browse for htnirs (we 
don’t mind), pick u|5 the items 
you want, and 'conveniently 
pay with ybdr major credit card 
at our virtual check-out, Then, 
kick buck and wait for your 
goodies to arrive - all without 
ever leaving your house! 


Miesi of all, you’ll shop confi- 
^denlly, because Developer 
Depot guarantees your com¬ 
plete satisfaction and lowest 
price for 3(1 days after your pur¬ 
chase. 


Talk about a safety net! 


That’s right, and speaking of 
nets, get connected and come 
check out the vastest on-line 
.selection of developer prod¬ 
ucts... any day, any time! 


http://www.devdepot.com 
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Subscriptions: US magazine: $47 for 12 issues (WTYRDM) 
Canadian: $59 for 12 issues {MTYRCM} 

Internationai: $97 for 12 issues (MTYRFM) 

Back Issues: $10 each (subject to availability) 


MacTech CD-ROM Volumes 1-11 

• 1420+ articies, from aii 127 issues of MacTech Magazine {1984-1995}. 

• Improved hypertext, and a new THINK Reference Viewer — for lightning 
quick access! • New hyperlinks between articles. • 100+ MB of source code 
— use them in your own applications, with no royaltiesi • Full version of THINK 
Reference™ - the original online guide to Inside Macintosh, Vols. I-Vi. 

• 80MB of FrameWorks/SFA archives. The most complete set of FrameW/orks 
archives known. • Sprocket"'! MacTech'sTiny Framework that compiles quick- 
iy and supports System 7,5 features. • The best threads from the Macintosh 
programmer newsgroups plus thousands of notes, tips, snippets, and gotchas. 

• Popuiar tools ftiat Macintosh programmers use to increase their productivi¬ 
ty and much more! 

List $89.00 Our Price $79 (SMTCD11} 

Upgrades: Our Price $39 (SMTCD11U) 


and get a 
free upgrade to the soon- 
to-be-released Volume 121 


(Free shipping on the upgrade!) 




MacTech Mouse Pad 

Slide on this! With an extra-large surface (11" by 10") and a deluxe sleek 
plastic coating, you'll be zooming across your screen in no time at all. 
Speed limit not enforced! 

Our Price $8.95 (AMTPAD) 


Best of MacTUtor 

The Best of MacTutor (^llection, Vols.3-5. 

List $93 Our Price $9.95 per set (BMTBEST). 


1-800-MACDEV-l • Outside U.S. & Canada: 805-494-9797 • Fax: 805-494-9798 
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Object-Oriented Fundamentals 1.1 

by Apple Computer, Inc. 

• DU'S multimedia Object-Oriented Fundamentals course enables 
you to easily make the paradigm shift from procedural to 
object-oriented design. It will introduce you to the entire object 
skill set, from general concepts through analysis and design. 
Tfris course includes a “lite" version of Metiowerks 
CodeWarrior integrated development environment for use in 
the labs. This course also includes a copy of the book Learn 
C-r-h on the Macintosh by Dave Mark. 

Our Price $245 (SOBORFU) 


AppleScript Software 
Development Toolkit 1.1 

by Apple Computer, Inc. 

• AppleScript language, system software 
extension, and script editor. 

• FaceSpan 1.0. 

• Developer's redistribution license for 
AppleScript System software extension and 
FaceSpan runtime code. 

Our Price $49 (SASDT) 

Apple Media Tool 
Programming Environment 2.0 

by Apple Computer, Inc. 

• This object-oriented language and ^plication framework 
allows programmers to customize features used within the 
Apple Media Tool authoring environment. 

• Includes an expanded Apple Media Language (AML) class 
library, incremental compiling and linking of AML code, faster 
debugging facilities, Macintosh Programmers' Workshop 
(MPW), and user-cmented documentation written from an 
AMTPE developer's perspective. 

• Portable across 68K. Power Macintosh, and Windows platforms. 
Our Price $995 (SAMTPE) 



Newton Toolkit 1.6 

by Apple Computer, Inc. 

With Newton Toolkit, you can easily 
create software that runs on any 
Newton PDA. including Apple's 
MessagePad and Motorola's Marco 

• Now supports Newton 2.0. 

• Dynamic Language Eases 
Development. 

• Allows you develop applications interacbvety. 

• New Compiler Enables Faster Applications. 

Newton Toolkit 1.6 Our Price $299 (SNETO) 

Newton Toolkit Update 1.6 Our Price $49 (SNETOUP) 



Newton Programmer’s 
Guide for Newton 2.0 

by Apple Computer, Inc. 


• The Newton Programmer's Guide consists of two volumes 
covering the Nevirton System Software, and one volume 
covering Newton Communications. 

• The two-volume set, Newton Programmer's Guide: System 
Software, is the definitive guide and reference tor Newton 
programming. This set of volumes explains how to write 
Newton programs and describes the system software rou¬ 
tines that you can use to do so. 

• The Newton Programmer’s Guide; Communications, 
describes the Newton communications system software 
for version 2.0. 

Our Price $149 (BNPGFN) 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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QuickTime VR 2.0 Authoring Tools Suite 

by Apple Computer, Inc. 

• QuickTime VR is a cross-platform software from Apple which 
enables webpage designers and professional developers to cre¬ 
ate new multimedia products and webpages incorporating 
QuickTime VR content. With QuickTime VR. users interactively 
navigate through 360" views of space, and explore three 
dimensional objects on Macintosh or Windows-based personal 
computers. 

• The QuickTime VR Authoring Tools Suite is a set of Macintosh 
tools to create and link panoramas and objects from photo¬ 
graphic, digital, video, or computer generated images. 

• Included is a complete set of documentation for planning, 
designing, photographing, and creating QuickTime VR panora¬ 
mas and objects. The authoring tools also allow you to link 
objects to panoramas using clickable hot spots. 

Included on the CDs are; 

• A software tool (MPW-based) that stitches and blends adjacent 
images into a panoramic PICT file. 

• A software tool (MPW based) that dices and compresses 
panoramic PICT files to less than 100 KB (low resolution) per 
panorama. 

• A scene editor (HyperCard-based) to create QuickTime VR 
scenes by adding and positioning nodes, hot spots, linking 
nodes together, and for linking QuickTime VR objects to 
scenes, 

• A variety of utility tools for formatting the data into the 
runtime software. 



Virtual Reality Programming with 
QuickTime VR 2.0 

by Apple Computer, Inc. 

• Virtual Reality Programming Book/CD-ROM tor QuickTime VR 2.0 

• Enables you to write C and C++ programs using QuickTime VR 2.[ 

• Allows QuickTime VR to be used in games, multimedia titles 
and other programs. 

■ QuickTime VR 2.0 objects can be zoomed In on. panned, or 
linked with hots spots. 

• Both panoramas and objects have hot spots linked to Worid 
Wide Web URLs. 

Our Price $39.95 (SVRPQT) 


Multimedia Authoring 
with Apple Media Tool 

by Apple Computer, Inc. 




Due to a revolutionary distortion correcting algorithm, QuickTime 
VR panoramas and objects maintain a normal perspective when 
the user moves the mouse. The speed of the algorithm allows up 
to 24-bit color images. Both vertical and horizontal panning can 
occur at fast speeds. 

Our Price $395 (SOTVRATS) 



QuickTime Developer’s Kit 2.0 

by Apple Computer, Inc. 

• QuickTime 2.0 Extension, QuickTime Power Macintosh 
Extension, and QuickTime Musical Instruments extension. 

• Utilities like MoviePlayer 2.0,16-bit Audio Compression, etc. 

• Sample content such as MPEG Movies, Music Movies. Time- 
Code Movies, and 60 field per second movies. 

• Includes software-only playback features such as faster 2x 
playback mode for current compressors, Apple Cinepak com¬ 
pressor. 1 -bit fast dithering, network tuning, load-Into-RAM 
option, and Photo CO support. 

Our Price $99 (SQTDK) 


Apple Media Tool offers new multimedia usero a way to get 
started creating interactive multimedia with minimal learning 
time. This self-paced tutorial wilt make Apple Media Toot (AMT) 
even easier to understand and to use. Using this tutorial, you will 
create a realistic multimedia project using exciting techniques 
such as QuickTime movies, animation and more. A demo version 
of AMT is included and can be used for the exercises. Training 
Format: Tutorial witli labs. 

Our Price $49.95 (SMWAMT) 

* Apple Dylan 

j liyiwnic abjcci nritntc4 itnd dinrdtjpniiPfH (?<nvflonmeti> 

Apple Dylan Technology Release 

by Apple Computer, Inc. 

• Contains a PowerPC-native prototype version of a development 
environment based on the Object Oriented Dynamic language 
(OODL) Dylan. Developers will be able to produce code target¬ 
ing both 680xD and Power Macintosh systems. 

• Automatic memory management. 

• Application framework and user-interface builder. 

• High-level exception handling. 

• Cross-language support for C code and APIs. 

CD & Online Documentation Our Price $39.95 (SADTRO) 
CD & Hardcopy Our Price $59.95 (SADTRH) 
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CodeWarrior 10 Gold 

by Metrowerks 

• New improved IDE * graphical browser view, global preferences and an improved external 
editor! 

• Full Java toolkit: project manager, linker, editor, class browser, source>level debugger, 
applet viewer and more! 

• Everything you need for industrial-strength programming. Develop for Macintosh, Power 
Macintosh, Windows 95, Windows NT, Magic Cap and BeOS. 

• Award-winning, easy-to-use IDE supports C/C+-t-, Object Pascal and Java. 

• Includes online books, extensive reference material and Apple Guide files lor easy naviga¬ 
tion through tutoriais and examples. Two free updates and technical support included 
with registration. 

Our Price $399 (SCWGOLO) 

SEE RELATED PRODUCTS: * Code Manager • Inside Power Plant • Inside CodeWarrior 9 
• C4 t PrograiTiming with CodeWarrior • PowerMac Programming Starter Kit • Discover 
Programming for Macintosli • Learn C on the Macintosh * Metnowerks CodeWarrior Programmrng 


Discover Programming for Macintosh 

by Metrowerks 

• Includes full working version of CodeWarrior along with three 
online tutorial books and Dave Mark's ‘Ljearn C on the 
Macintosh" converted to y^pleGuides. 

• Includes C, Ch-+ and Object Pascal compilers for generating 
68K Macintosh code, source-level debuggers, object-oriented 
frameworks {PowerPlant, MacApp), Apple's MPW, complete 
online documentation and source code examples for all lan¬ 
guages and platforms. 


The IDE software has been localized in eight languages plus 
English. This product is not sold as a subscription. 

Includes a 3 monUi subscription to MacTech Magazine. 

Our Price $79 (SCWDiSCMAC) 

SEE RELATED CATEGORY: Dev. Environments 



CodeWanior for BeOS DR2 

by Metrowerks 

• Start programming for the new, innovative Be Operating System 
(BeOS) with complete set of Codewarrior tools 

• BeOS-native Integrated Development Environment (IDE) with all the 
familiar CodeWarrior features at your fingertips 

• A BeOS PowerPC compiler and linker, an editor w/syntax color and 
styling, and a source-level debugger 

• BeOS header and libraries, complete documentation, useful C-l-^ 
classes, and sample code 

• Ihe Be Operating System DR8.2 for Power Macintosh will allow you 
to run and program for the BeOS on a 603 or 604 PCI based 
PowerMac 

Our Price $149 (SCWFB) 


Codewarrior Wear (xl omy) 

You live it, you breath ft... you might as well wear it! 

• Black Codewarrior Sweatshirt: 

Our Price $29.95 (ACWSWEAT) 

• “Blood, Sweat & Code" black short-sleeve shirt: 

Our Price $9.95 (ACWSBLOOD) 

• Hawaii Rve-0 shirt: 

Our Price $7.95 (ACWHAWAII) 

• Arnold at work T-shirt; 

Our Price $9.95 (ACWARNLD) 

• Hat: Our Price $14.95 

Please Specify: Black (ACWBHAT) or White (ACWWBHAD 

• Winter Hat (see Web site) 

Our Price $14.95 (AWINHAf) 



Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
















Symantec C++ 8.5 

by Symantec Corporation 


• Native for Power Macintosh. 

• Develop full-featured Power Macintosh applications quickly and easily! 

• Environment includes; a true native Power Mac implementation of the C++ 
language, MrC/MiC++ compilers for fast Power Mac executable code, 
Visual Architect for fast, easy GUI generation, a new THINK project manage¬ 
ment system that supports complex applications, a new editor^rowsef, a 
powerful, easy-to-use source code debugger. 

• Also includes: The industry-standard THINK Qass Library! 

• Next two updates free when you send In your registration card and morel 


List $499 Our Price $349 (SSYMCPP) 

SEE RELATED PRODUCT; Symantec C++ Programming, Leam C++ on the 
Macintosh, Programming in Symantec C++, Mastering theTHINK Class Library. 


Symantec C++ for 68k 

by Symantec Corporation 

• The standard in development languages. • Powerful combination of fully integrated visual tools and the latest in C and 
C++ compiler technology. • Provides an object-oriented approach to application development. • Write code that is exten¬ 
sible, reliable, and maintainable. Includes: Integrated Environment with full source-code debugging. Incremental Linker 
which eliminates long link times. THINK Class Library, AppleEvents, Visual Architect™, THINK Inspector, Project Models, 
Source-Code Control with integration with Apple’s SourceServer (included), Support for Scripting, Powerful Standard 
Libraries which includes I/O Streams, ANSI standard C library, and sample programs. • Full source code is included - 
Create applications that run on 68K Macs and Power Macs (emulated). These applications can easily be migrated to 
native Power Mac, by trading up to Symantec C++ for Power Mac. 

List $299 Our Price $99 (SSYMCPP68K) 


Think Pascal Version 4.0 

by Symantec Corporation 

• Great for professionals and students 

• Fully integrated for rapid turnaround time - 
take advantage of System 7 capabilities 

• Supports large projects, enhanced THINK Class 
Library, System 7 compatibility, superior code 
generation, and smart linking. 

• Includes four Macintosh disks, a user manual, 
and an object-oriented programming manual. 
Our Price $165 (SPASCAL) 


Power MachTen-UNIX 

by Tenon Intersystems 

• Dynamically linked shared Itbranes, memory mapped file 
access and integrated UNIX and Macintosh development tools. 

• BSD 4.4 and conforms to the Federal Information Processing 
Standard 151-2 (the POSIX FIPS). 

• Pre-emptive multitasking for UNIX applications and includes a 
lull featured high-performance TCP/IP protocol stack that sup¬ 
ports multi-homing and multi-casting, features not yet avail¬ 
able even with Apple’s new Open Transport. 

• A complete UNIX software development environment with a 
source-level debugger and C, C++, and Fortran compilers all 
generating native PPG code. 

• Also included is a high-performance X server and complete 
X11R5X. 

Our Price $695 (SM10PPC) 

SEE RELATED CATEGORY: Internet Related 


Fortran 77SDK 



by Absoft Corporation 



For Power Macintosh includes a globally optimizing native compiler and linker, native Fx*” multi-language debugger, and Apple’s 
MPW development environment. 



• The compiler is a full ANSI/ISO Fortran 77 imptementation, and includes all MIL-STD1753 extensions, Cray/Sun-style POINTER, 
and several Fortran 90 enhancements • MRWE, Absoft’s framework library is included in the MIG graphics library • Supports the 
native Macintosh PPC toolbox • Includes Absoft’s Fx debugger which can debug intermixed FORTRAN 77, C, C++, and PPC assem¬ 
bler • The linker compiler, and debugger all run as native PPC tools, and produce Macintosh PPC executables 

Our Price $699 (SF77) 

1-^800-MACDEV-l • Outside U.S. & Canada 805-494-9797 • Fax: 805-494-9798 












NS BASIC 3.5 for the Newton with Visual Designer 

by NS BASIC Corporation 

• A fully interactive implementation of the BASIC programming language. • Runs entirely on the Newton - 
no host is required. 

• Create files, access the built-in soups, and the serial port for input and output. • Work 
directly on the Newton, or through a connected Mac/PC and keyboard. 

• Get the BASIC Internet Tool, available at no charge to NS BASIC users from www.nsba- 
sic.com. Release Notes with sample code are available from the same location. • Runs on 
any Nevrton MessagePad 130 with NS BASIC and the Newton Internet Enabler. Wso runs on 
MP 1201s with NOS 2.0 that have full memory available. * Write short programs to access News, mail and the web.» Create cus¬ 
tom newsreaders that do filtering or archiving • Load a spreadsheet or stock trade triggering program with stock prices from the 
web. • Send mail containing data collected in an NS BASIC program • Update a database with data sent by email. 

List $99 Our Price $94.99 (SNS8ASIC) 



Presenting Magic Cap, A Guide to General Magic’s 
Revolutionary Communicator Software 

by Barbara Knaster 

• Perfect for novices as well as experts who want to take full advantage of Magic Cap. 

• Step through its screens, see how it works, and learn ways to use it. 

• Describes the power of smart messaging to customize the way you handle e- mail, a name card 
file that learns how to keep track of your contacts, a datebook that performs like a faithful assis¬ 
tant, and countless other abilities. 

List $16.95 Our Price $15.25 (BPRESMAGfQ 



Personal MacliTen for 68K Macs Ordcf TolMree 

by Tenon Intersystems 8004U(DEV-I 

• MachTen UNIX for Macintosh (from Classic on up, including PowerBooks and Duos) 1805622-3381) 

• A Mach-based Berkeley UNIX with pre-emptive multi-tasking 

• Extends the Mac OS with UNIX networking and software development tools. 

• Built-in internet services include domain name service, POP mail service, internet routing. SUP & PPP, and Web service. 
Our Price $495 (SMtOPER) Also Available: MachTen XWindows Our Price $350 (SMACHX) 

SEE RELATED CATEGORY: Internet Related 


1 * i Here’s a list of all available products. 

VMo»'®V For full product descriptions please see our Web site, or feel free to call, 
fax, or E-mail us. 


PRODUCT 

CODE 

LIST PRICE 

OUR PRICE 

Personal MachTen for 68K Macs 

SM10PER 

$600.00 

$495.00 

CMaster 

SCMASTER 

129.95 

129.95 

CodeWarrior Discover Java 

SCWDISCJAVA 

99.00 

99.00 

LPA MacProlog Developers Edition 

SLPAD 

1500.00 

995.00 

LPA MacProlog Programmers Edition 

SLPAP 

745.00 

495.00 

LS FORTRAN 

SLSFORT 

695.00 

595.00 

Mac FORTRAN II 

SF0RT2 

595.00 

549.00 

Professional MachTen for 68k Macs 

SPR0M10 

695.00 

695.00 

SmalltalkAgents 

SSTA 

695.00 

695.00 



Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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Roaster Subscription 

By Natural Intelligence Inc. Get the most out of Sun’s 
new Java'" Programming Language! 

• Write, test and run Java applets on the Macintosh in a full- 
featured Mac development environment 

• Features include; project window that includes a finder-like 
view of packages. Macintosh native compiler, source code edi¬ 
tor with powerful search features and intuitive use interface, 
runtime engine for quick and easy applet testing. 

• Requirements: PowerPC based Macintosh, CD-ROM. 

• Price includes the current DR 2 release and the next two non-developer releases. 
List $399 Our Price $299 (SROAST) 

SEE RELATHl CATEGORY; Dev. Environments 


Roaster 

By Natural Intelligence Inc. 

• Price includes the current DR 2 release 
and the first non-deveioper release. 

List $179 Our Price $129 (SROAST1) 
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Symantec Cafe 

by Symantec Corporation 

Symantec Cafe tor Macintosh is a stand¬ 
alone, professional Java development environment that replaces the previously released Symantec 
Caffeine Java tools. Caf^ is ideal for both novice and professional Java developers. Cafe includes an 
"Intro to Java Programming" tutodal, Java language reference, Cafe Studio visual tods for graphically 
drawing Java applets on screen and having the corresponding source code generated automatically, 
and over 90 sample applels that can be easily modified to create your own custom applets. 

• For professionals familiar with programming, Cafe provides an unrivaled feature set, including an inte 
grated graphical class browser, fast native Java compiler, a full-featured project manager, a profes¬ 
sional Java source code editor, and full support for Af^eScript and AppleEvents for automating time 
consuming tasks. 

• Cafe comes with one year of free access to Symantec Java Central, including the right to download 
patches and updates as they become available. 

Our Price $99 (SSYMCAFE). SEE RELATED CATEGORY: Dev. Environments 


OOFILE Reporter Writer by A.D. Software 

This Is a full embedded report-writer, allowing you to preview page-by-page and either print or save as plain text. HTML or RTF. 
Multiple levels of breaks, database views and headers and footers are provided using a clean object-oriented design. Incudes RAM- 
based version of OOFILE database. Included in full OOFILE Platform Bundle. Price includes 1 -tear subscription. Saving to file without 
preview of printing is cross-platform-run on your MacANin/Unix server and create Web Pages. 

Our Price $500 (SOORW) 


TCP/IP Scripting Addition by Mango Tree Software 

• Award-winning AppleScript scripting addition 

• Allows you to write scripts using MacTCP™ commands in AppleScripF”. 

• Send e-mail or files through a script, check if users are logged on (via Rnger), automate 
FTP, Gopher. NetNews, Telnet, and LPR, verify links in HTML documents, and quickly write 
many other TCP/IP client-server programs. 

• Works with AppleScript, MacTCP 2.0.4 and Open Transport 
Our Price $49 (STCP) SEE RELATED CATEGORY; Scripting 
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The*'®? Here’s a list of more products. For full product descriptions please see our 



Web site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CodeWarrior Discover Java 

SmalltaikAgents 

Tenon Ported Applications CD 


CODE 

SCWDISCJAVA 

SSTA 

SPORTED 


LIST PRICE 

$99.00 

695.00 

50.00 


OUR PRICE 

$99.00 

695.00 

49.95 


1-800-MACDEV-l • Outside U.S. & Canada: 805-494-9797 • Fax: 805-494-9798 


































FaceSpan v2.1 

by Digital Technology International 

• Develop Integrated Software • Make Stand Alone Applications • Create Friendly 
Interfaces • Develop Quick Prototypes • Print multiple pages with sophisticated layouts 

■ Script essential elements of the FaceSpan application • Play and record sounds as 
either ‘snd" resources or as “AiFF" files. • Create miniature or complete applications 
that will run on either Power PC or 68k computers. • Use precise time measurement for 
implementing timed behaviors. • Enhanced Save Options ■ New Properties 

■ Proportionally scale PICT images • Align images in a pictbox • Monitor and respond to 
low-memory situations • Automate any application ■ Increased support for Frontier 
UserTalk! 

List $299 Our Price $279 (SFACESPAN) 


Script Debugger 

ly Late Night Software Ltd. 

> A powerful and flexible AppleScript authoring tool - get the most from AppleScript! 

> Advanced debugging environment offers single-step script execution with breakpoints. 

• Script Debugger dictionary browser features a graphical view of objects provided by 

scriptable applications. 

' Includes Late Night Software Scripting Additions - a collection of more than 70 new 
AppleScript commands, and Scheduler, a utility that allows you to launch scripts at pre¬ 
determined times. 

List $129 Our Price $119 SDEBUG) 



New 2 , 0 ! 



Scripter 2 .0 by Main Event Software 

• Whether you’re looking for a toot to introduce yourself to AppleScript’s unmatched capabili¬ 
ties. or a well-crafted development environment, Scripter, the Script Construction Set, is the 
obvious choice. FaceSpan 2.x integration: if you use the FaceSpan 2.x interface creation envi¬ 
ronment from Digital Technology international, you can use Scripter seamlessly instead of 
FaceSpan's basic editor, to write, test and debug scripts attached to objects in FaceSpan. 

• Scripter and FaceSpan work together; one click opens your FaceSpan script in Scripter, 
another sends It back. • Debug handlers without modifying your scripts using the Call Box, a 
special window tor calling individual routines in a script. • Live editing: simulate applet. CGI. 
FaceSpan messaging Interactively debug live inter^plicatlon messages sent to a script appli¬ 
cation or AppleScript CGI from an applet, your Web server or FaceSpan 2.x. You won't have to 
modify your Web pages or your CGIs. • ScriptBase is now included with Scripter. Use it to 
store your data and media elements (frequently used values, text, pictures, scripts, HTML, 
headers, file references) and share them between scripts all with a special new browser. • 
Easily write and compile scripts that have handler declarations and other vocabulary specific 
to a particular scriptable application. • Scripter is the natural companion to AppleScript for 
users at all levels of proficiency. Don't write scripts without it! 

List $199 Our Price $179 (SSCRIPTER) 
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Here are more products. For full product descriptions please see our Web 
\ot^/ site, or feel free to call, fax, or E-mail us. 


PRODUCT 


CODE 


LIST PRICE 


OUR PRICE 


OogPatch 
PreFab Player 
ScriptBase 
ScriptWIzard 


SDOGPATCH $299.00 $199.00 

SPLAYER 95.00 95.00 

SSCPTBASE 59.00 59.00 

SWIZ 89.00 84.95 



Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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BBEdit 4.0 

by Bare Bones Software 

• A powerful, easy-to-learn text editor. 

• Adds new features for HTML coders, including a spelling 
checker and HTML tag palette. 

• Accelerated for Power Macintosh; dragging supported every¬ 
where; Internet Config aware; PowerTalk aware. 

• Integrated support for Symantec’s IDE, Melrowerks 
CodeWarrior, THINK Reference 2.x, MPW ToolServer, and most 
other environments. 

• Many UNIX style tools, including 'grep" searches, file compar¬ 
isons, and sorting. Multi-file search and replace. 

• PopUpFuncs feature lets you jump to a function from a menu. 


List $119 Our price $94 ^BBEDIf) 



QUED/M 3.0 

by Nisus Software 

• The programmer’s text editor that defined the industry 
standard for speed and efficiency. 

• PowerPC native. 

• Features integrated support for Symantec C/C4-t-, 

Metrowerks CodeWarrior 6. and MPW. 

• Supports all the major development environments on the Macintosh. 

• Dozens of powerful editing features, including unlimited undo and redo, 
macro language, scripting, text folding, ten editable/appendable cliftooards, 
markers, displaying text as ASCII codes, dynamic coloring of C/Ch-i- key¬ 
words/comments. rectangular and non-contiguous selection. 

• Includes Celestin Company's APPRENTICE 4. 

List $149 Our Price $89 (SQUEDM) 


Movie Cleaner Pro 1.2 

by Terran interactive 

• Compress QuickTime movies 

• Powerful and easy-to-use 

• Includes: drag and drop batch processing, suspend and resume, 
adaptive noise reduction, IMA audio compression, high duality crop 
and resize, AA/ fades, gamma correction, de-interlacing and more! 

• Automatically suggests the best settings for your application. 

• Great for both beginners and experts 

• Essential for CD-ROMs or Web sites 
Our Price $189.95 (SMOVIE) 

SEE RELATED PRODUCTS: Quick Time Official Guide 




1-800-MACDEV-l • Outside U.S. & Canada: 805-494-9797 • Fax: 805-494-9798 



















CronManager 

by Orchard Software 

• ImptefTienta the UNIX Cron facility, 

• Open any Macintosh file on a given date and time, 

• Simple interface. 

• Works with any Macintosh fiie. 

• Cron Manager bundled with Climate, 

Our price $26.95 (SCRONMGH) 
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CodeManager 

by Metrowerks 

• Source code controi system for the Macintosh, 

• Based on and compatible with Microsoft Visual SourceSafe version 4,0, 

• Works with any type of binary fiie including graphic, database, library 
and executable files. 

• Includes support for multi-platform projects, security features, reverse 
delta versioning of flies, comment areas for each revision, project 
analysis and reporting tools. 

• Sold on a subscription basis with two fuftjre product updates. 

■ Includes a 1 year MacTech subscription. 

Our Price $399 (SCDMGR) 

SEE RELATED CATEGORY: Dev, Environments 

CPU Doubler 

by Orchard Software 

• Performance enhancement utility for the 
Macintosh. 

• Increases the speed of your computer by 100%. 

• Works on both the PowerPC and 68K Macintosh. 

• Manages computer throughput using a propri¬ 
etary scheduling algorithm. 

• Ensure optimal performance and compatibility. 

Our Price $79.95 (SCPU2X) 


Order TelMree 
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NeoAccess 

by Neotogic 

• Full-featured object daMjase engine for use in Macintosh, 
Windows, Unix and DOS based C-i-i- applications, 

• Extended binary frees and binary search algorithms tuned fa 
short access times; dynamically combined, collapsed, and 
compressed indices; object caching fa instant access to 
prewously usol objects. 

• Build test, powerful applications in recad time! 

Our price $749 (SNEO) 


Guide Composer 1.2 

by StepUp Software 

• Create powerful Apple Guide help systems for any new or existing Macintosh application. 

• Provides a WYSIWYG development environment: Guide content is developed in Guide windows. 

• Design topics, phrases, and panels in the same format as the user will use them. Features are Vi/YSiWYG interface. 

Topics, phrases, and hierarchical phrases. Coach marks, Fully-Integrated with Apple’s Guide Maker (distributed with Guide 
Composer), compiles scripts automatically, PICTs in Panels, Generated Guide scripts are modifiable. 

• FREE Update to all registered Guide Composer users. Demo Is available at http://www,gu!d8works.com/. 

Our Price $99 (SGCOMP) 

SEE RELATED PRODUCTS: AppleGuide Complete, Danny Gcxxlman’s AppleGuide Starter Kit, Real World AppleGuide 


Web site: http://www.devdepot.conn • E-mail: orders@devdepot.com 





























Memory Mine 

by Adianta Inc. 

■ Monitor heaps, identify problems such as memory leaks, 
and stress test applications 

• Active status of memory in a heap is sampled on the fly: 
allocation in non-relocatable (Ptr), 

relocatable (Handle) and free space is shown, as are heap 
corruption, fragmentation, and more 

• Allocate, Purge, Compact, and Zap memory lets users 
stress test all or part of a program 

List $99 Our Price $94.99 (SMEMMINE) 

SEE RELATED CATEGORY; Dev. Environments 



VOODOO 

by UniSoftware Plus 

• Version control tool for the simple and clear management of projects in which files 
are created in numerous versions (variants and revisions). 

• Allows both variant and revision control, and it manages not only variants and rev 
sions of single files, but of a whole software project (multi files, multi users, multi 
variants, access rights, etc.) 

• Graphical user Interface and is not only suitable for mere source code control but can handle all different kinds of files with 
amazing compression rates: typical size of delta between arbitrary files 5% 

• Please note special prices for multiple copies: 

Single license $229 (SV00D001); 2 pack $359 (SVOODOOZ); 5 pack $799 (SV0OD005): 

10 pack $1369 (SV0000010); 20 pack $2399 (SVOODOO20) 

Additional pricing available on request, 

SEE RELATED CATEGORY: Dev, Environments 

QC High performance runtime stress testing for applications, 
by Onyx Technology 

• Tests include heap checks, purges, scrambles, handle/pointer validation, dispose/release 
checks, write to zero, de-reference zero as well as other tests like free memory invalida¬ 
tion and block bounds checking. 

• Extremely user friendly - ideal for non-programmer testers. 

• Also available in Japanese. 

List $99 Our price $94.99 (SQC) 


StoneTabie 

by StoneTablet Publishing 

• Replaces all functions found in list manager 

• Variable size columns/rows; different font, size, style, forecolor, 
backcolor per cell; sort, resize, move, copy, hide columns/rows: 
edit cells/titles in place; titles for columns/rows; multiple lines 
per cell; grid line pattem/color; greater than 32k data per 
table: up to 32k text per cell; support for balloon help and 
binary cell data. Versions for Think C, Think Pascal, MPW C, 
MPW Pascal, CodeWarrior 6 C. 

StoneTabie Extra 

by StoneTablet Publishing 

• Drag selected ceils within table or to other tables. 

• Add rows as part of drag; popup menus or check boxes In 
cells; variable width grid lines; move/drag/resize table in 
window; clipboard operations on multiple cells. 

• Requires StoneTabie, 


This product can now be ordered in 3 different packages, 

68K StoneTabie 

This includes StoneTabie, StoneTableExtra for Think Pascal, Think 
C, MPW C, MPW Pascal, CodeWarrior C, CodeWarrior Pascal 

Our price $175 (SST0NE68) 

PPG StoneTabie 

This includes StoneTabie PPG, StoneTableExtra PPC for Think 
C, MPW C, MPW Pascal, CodeWarrior C, CodeWarrior Pascal 
Our price $175 (SSTONEPPC) 

68K/PPC StoneTabie 

Includes both packages 
Our price $325 (SSTONEFAT) 




1-800-MACDEV-l • Outside U.S. & Canada: 805-494-9797 • Fax: 805-494-9798 





































SoftPolish CD-ROM by Bare Bones Software 

• Tl>e essential tool for software quality assurance on the Macintosh 

• Helps you identify inconsistencies with Apple’s user interface guidelines, 
misspelled words, missing resources, and other mistakes 

• Provides tools to put the finishing touches on software distribution 
packages prior to release 

• Works independently of any programming language or environment 

• Ideal for sanity checking software throughout the developmrent process. 
List price: $99 Our price: $89 (SSOFTPOL) 



PoweiTap by Fortner Research 

• Offers a simple method of implementing multi-processor 
capabilities to any application. 

• Creates applications that are compatible with Apple's 
DayStar and other multi-processing computers. 

• Compatible with Fortran, C, and C-I-+ programming 
environments, 

• Adjustable slide bar controls the level of CPU-stiaring. 

• Contains Thread Manager Options. 

• Available now for MPW, CodeWarrior, Symantec Project 
Manager, PowerPC, A5, and A4. 

Our Price $299 (SPOWTAP) 


PictureCDEF1.3 by Paradigm Software 

• Professional-level CDEF for creating custom graphical buttons 
(8-64 pixels) - used in producte by Adobe, ProVue, STF 
Technologies and others! 

• Multi-monitor and bit-depth sensitive. 

• The button graphic (cicn, ResEdit) can be changed at runtime 
and even animated with a call-back routine, 

• Create distinct buttons in seven variations: MultiState, 
PushButton, FlexiButton, ToggleButton, ChkButton, 
PushPictButton and TogglePictButton. 

• Manual, sample code and MacApp 3.0 support included. 

Full source code: $95 (SPCDEF) 

Object code: $45 (SPICTOBJ) 



• True relational database system for Apple Macintosh computers. 

• Provides a powerful choice for developers who want to create 
database centered applications with no performance trade-offs. 

• Features SQL, full transaction control, error recovery, single 
user, client server architecture and multi-platform support 
including DOS, Windows, OS/2 and UNIX. 

• The C/C4-(- API is identfcal and fully portable across all 
supported platforms. 


• Third-party vendor supporting dtP will be able to offer a 
variety of advanced features and benefits to their customers 
royalty free. 

• Tools are included for importing, exporting, creating and 
managing databases and users, 

• Supported development environments include: Symantec, 
MPW, Metrowerks and more. Mac/SOK 

List $695 Our Price $679 (SDTF) 


Spyer by mcider 

• Easy to use tool that records all actions (including mouse 
movement) you perform on a Macintosh computer and then 
replays them at your preferred speed. 

• Recorded data can be saved in files for future use. 

• Works as a background process with any Macintosh appli¬ 
cation and is triggered by user defined Hot Keys, 

• Enables the "Continuous Redo" utility and is especially use¬ 
ful for software testing and demonstration. 

Our price $39 (SSPY) 


Spellswell Plus 2.0.4 by Working Software 

• Award-winning, comprehensive, practicaJ spelling checker that 
works in batch mode or vi/ithin applications that incorporate the 
Apple Events Word Services protocol (e.g., Eudora, 

WordPerfect, Communicate!, and InfoDepot), 

• Checks for spelling errors as well as common typos like capi¬ 
talization errors, spaces before punctuation, double word 
errors, abbreviation eirors, a/an before vowel/consonant, etc. 

• MacTech orders Include developer kit with Writeswell Jr., a 
sample AppleEvents Word Services word-processor and its 
source code. 

• Available for OEM Sales. 

Our price $74.95 (SSPELL) 



Web site; http://www.devdepot.com • E-mail: orders@devdepot.com 



















B-'n-ee HELPER 2.2 

by Magreeable Software 

• Inexpensive database engine tor Macintosh programmers 
in C source code. 

• Uses contiguous fixed length blocks. 

• Expands the file as necessary and contracts fries when 
possible. 

• Inserts and deletes keys in one or more B-Trees. 

• Finds keys equal to, less than, or greater than a given 
value in a few hundredths of a second. 

• Finds lists of records whose keys are equal to, less than, 
or greater than a given value or are in a range of values. 


Our Price $150 (SBTREE) 


Step-Up Installer Pack 

by StepUp Software 

• Package of several Installer "atoms” that let developers 
incorporate graphics, sounds, file compression and cus¬ 
tom folder icons into installation scripts. 

• Compression formats supported are Compact Pro & 
Diamond. 

• Each atom also available separately. 

• Compression requires additional licensing. 

Our price $219 (SINSTALL) 



TestTh’ack-Bug It'acking the 
Macintosh Way 

by Seapine Software, Inc. 

• Tracks bugs, feature requests, test configurations, 
users, ^d more. 

• Includes notifications, security, a powertui filter 
mechanism, and multiple reports. 

• Links your testers, engineers, documentations staff, 
and project managers together to ensure all bugs are 
identified, fixed, and documented. 

• Biminates the need to build custom bug tracking 
solutions using general purpose database tools. 

• Supports single- and multi-user bug databases (addi¬ 
tional licenses required to use mulfi-user features). 
Our price $129 (STETR) 


ScriptGen Pro 

by StepUp Software 

«Installer script generator which requires no programming 
or knowledge of Rez. 

• Supports StepUp's InstallerPack. Stuffit decompression. 
Compact Pro 

decompression, custom packages, splash screens, net¬ 
work installs, and resource installation. 

Our price $169 (SSCRPTGEN) 



AppMaker 

by Bowers Development 

• Develop the user interface for a Macintosh application 
using the original interface builder. 

• Just point and click to design your application. 

• Creates resources and generates excellent source code. 

• Supports most development environments including 
Metrowerks, Symantec, or MPW; 

C, C++, or Pascal; procedural or object-oriented, using 
PowerPtant, TCL, or MacApp. 

• The generated code uses the Universal Headers to provide 
PowerMac compatibility. 

• Great tool for beginners to learn object-oriented and 
Macintosh Toolbox programming techniques. 

• Includes one-year subscription on CD and hardcopy 
dxumentation. 

List $299 Our Pnce $279.99 (SAPPMAKE) 
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see our Web 

jyiol *^* J site, or feel free to call, fax, or E-mail us. 
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CODE 

LIST PRICE 

OUR PRICE 


30 Game Machine 

S3DGAME 

$299.00 

$299.00 


AdLib 

SADUB 

195.00 

195.00 


Animation Class Library 

SACL 

250.00 

250.00 


CLImate 

SCUMATE 

59.95 

59.95 


CMaster 

SCMASTER 

129.95 

129.95 


DataScript 

SWDSCRIPT 

249.00 

229.99 


ICONIX PowerToois-IO Pack 

SICPP10 

7,995.00 

7,845.00 


ICONIX PowerTools-6 Pack 

SICPP6 

5,995.00 

5,945.00 


ICONIX PowerTools-8 Pack 

SICPP8 

6,995.00 

6,945.00 


ICONIX PowerTools-AdaFlow 

SICADA 

1,495.00 

1,395.00 


ICONIX PowerTools-ASCII Bridge 

SICASCII 

1,495.00 

1,395.00 


ICONIX PowerTools-CoCoPro 

SICCOCO 

1,495.00 

1,395.00 


ICONIX PowerTools-DataModeler 

SICDATAMOD 

1,495.00 

1,395.00 


ICONIX PowerToots-FastTask 

SICFASTTASK 

1,495.00 

1,395.00 


ICONIX PowerTools-FreeFlow 

SICFREEFL 

1,495.00 

1,395.00 


ICONIX PowerTools-Object Modeler 

SICOBJMOD 

1,495.00 

1,395.00 


ICONIX PowerTools-PowerPDL 

SICPOWER 

1,495.00 

1,395.00 


ICONIX PowerTools-QuickCharl 

SICQUICKCH 

1,495.00 

1,395.00 


ICONIX PowerTools-SmartChart 

SICSMART 

1,495.00 

1,395.00 


ICONIX Training & Consulting 

TICONIX 

3,000.00 

2,945.00 


IMSL Math and Stat F77 

SIMSLSTAT 

495,00 

495.00 


Info-Mac VIII 

SINF0MAC8 

39.95 

35.95 


LJ Profiler 

SUPROF 

295,00 

295.00 


Mac Games II 

SMACGAMES2 

29.95 

26.95 


Mac Source 

SMACSOURCE 

29.95 

26.95 


MacA&D Demo 

SMACAOD 

149,00 

75.00 


MacA&D Product 

SMACADP 

2,995.00 

1,995.00 


MacAnalyst Demo 

SMACAND 

79.00 

74.95 


MacAnalyst Product 

SMACANP 

995.00 

945.00 


MacAnalyst/Expert Demo 

SMACANED 

79.00 

74.95 


MacAnalyst/Experf Product 

SMACANEP 

1,595.00 

1,545.00 


MacDesigner Demo 

SMACDESD 

79.00 

74.95 


MacDesigner Product 

SMACDESP 

995.00 

945.00 


MacOesigner/Expert Demo 

SMACDESED 

79.00 

74,95 


MacDesigner/Expert Product 

SMACDESEP 

1,595.00 

1,545.00 


MacScholar 

SMACSCHOL 

29.95 

26.95 


MacScholar Jr, 

SMACSCHOLJR 

29,95 

26.95 


MacWireFrame 

SFRAM 

299.00 

75.00 


MAScript 

SMASCRIPT 

199.00 

195.00 


More Savvy 

SMORSAV 

450.00 

445.00 


PowerMac 2 

SP0WERMAC2 

29.95 

26.95 


Professional MachTen for 68k Macs 

SPR0M10 

695.00 

695.00 


Rosanne 

SROSANNE 

595.00 

595.00 


S-Case 

SSCASE 

495.00 

395.00 


Savvy 

SSAVW 

250.00 

245.00 


Savvy QuickTime 

SSAWYQT 

250.00 

245.00 


StoneTable for 68K 

SST0NE68 

175.00 

175.00 


StoneTable for PowerPC 

SSTONEPPC 

175.00 

175.00 


Super Savvy 

SSSAWY 

700.00 

695.00 


SuperPlot 

SSPLOT 

195.00 

145.00 


SuperPlot Pro 

SSPLOTPRO 

349.00 

349.00 


Tenon Ported Applications CD 

SPORTED 

50.00 

49.95 


Top 10 Pick for Macintosh 

ST0P10PICK 

49.95 

44.95 


V3d/3dPane/SmartPane 

SQ3 

192.00 

192.00 


VText 

SVTEXT 

350.00 

350.00 


Web site: http;//www.devdepot.conn • E-mail: orders@devdepot.com 














Inside Macintosh: CD-ROM by Apple Computer, Inc. 

• More than 25 volumes in electronic form. 

• Includes: QuickDraw^** GX Ubrary, Macintosh Human Interface 
Guidelines, PowerPC System Software, Macintosh Toolbox Essentials 
and More Macintosh Toolbox. QuickTime and QuickTime Components 

• Access over 16.000 pages of information with Hypertext linking and 
extensive cross referencing. 

List $99.95 Our Price $89.95 (BIMCD) 






WAf- 

There* Here are all of the Inside Macintosh products - half off! For full product 
descriptions please see our Web site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

LIST PRICE 

OUR PRICE 

Inside Macintosh; AOCE Applications interface 

BIMAOCE 

$44.95 

$21.99 

Inside Macintosh; AOCE Service Module 

BIMAOCES 

29.95 

14.50 

Inside Macintosh: Devices 

BIMDEV 

29.95 

14.50 

Inside Macintosh: Files 

8IMFIL 

29.95 

14.50 

Inside Macintosh: Imaging with QuickDraw 

BIMIMAG 

32.95 

15.99 

inside Macintosh; Interapplication Communications 

8IMIAPP 

36.95 

17.99 

Inside Macintosh: Macintosh Toolbox Essentials 

BIMTBOX 

39.95 

17.45 

Inside Macintosh: Memory 

BIMMEM 

24.95 

11.99 

Inside Macintosh; More Macintosh Toolbox 

BiMMAC 

34.95 

16.99 

Inside Macintosh; Networking 

BIMNET 

29.95 

14.50 

Inside Macintosh: Operating System Utilities 

BIMOPSU 

28.95 

13.99 

Inside Macintosh; Overview 

BIMOVER 

24.95 

11.99 

Inside Macintosh: PowerPC Numerics 

BIMPPCNUM 

28,95 

13.99 

Inside Macintosh: PowerPC System Software 

BIMPPCSYS 

24,95 

11.45 

Inside Macintosh; Processes 

BIMPROC 

22.95 

10.99 

Inside Macintosh: QuickDraw GX Environ. & Utilities 

8IM6XENV 

31,95 

15.50 

Inside Macintosh: QuickDraw GX Graphics 

BIMGXGR 

31,95 

15,50 

Inside Macintosh; QuickDraw GX Objects 

BIMGXOBJ 

31.95 

15.50 

Inside Macintosh: QuickDraw GX Printing 

BIMGXPRNT 

29,95 

14.50 

Inside Macintosh: QuickDraw GX Printing Extensions 

BIMGXEXT 

29,95 

14.99 

Inside Macintosh: QuickDraw GX Prog. Overview 

BIMGXOV 

24.95 

11.99 

Inside Macintosh: QuickDraw GX Typography 

BIMGXTYP 

29,95 

14.50 

Inside Macintosh: QuickTime 

BIMQT 

29,95 

14.50 

Inside Macintosh; QuickTime Components 

BIMQTCOM 

34.95 

15.95 

Inside Macintosh: Sound 

BIMSOUND 

29.95 

14.50 

Inside Macintosh; Text 

BIMTEXT 

39.95 

19.50 

Inside Macintosh: X-Reference 

BIMXREF 

19.95 

9.50 
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Programmer’s Toolbox Assistant CD-ROM 

Instant electronic access to Inside Macintosh essentials, 
by Addison-Wesley Publishing 

• Get quick access to reference pages for over ^,000 Toolbox calls in 
your system software from their development environment. 

• Essential information for Macintosh software developers. 

• Hypertext links allow programmers to view related topics easily. 

• The ultimate electronic reference tool for Macintosh programmers. 

List $99.95 Our Price $89.95 (STBASST) 


AppleScript Applications: Building 
Applications with FaceSpan and 
AppleScript 

by John Schettino Affiliation & Liz O’Hara 

• Build complete AppleScript applications using FaceSpan, a 
user interface development tool that makes AppleScript appli¬ 
cations truly “Mac-Like" • Uses a step-by step approach to 
demonstrate techniques tor building applications through illus¬ 
trations and samples • Provides Graphical User Interface (GUI) 
design tips and practical approaches for implementation 

• Contains one CD-Rom with AppleScript l.i, a demonstra¬ 
tions version of FaceSpan 2.1, source code for all example 
applications numerous AppleScript shareware and demonstra¬ 
tions programs • Contains a section on debugging AppleScript 
applications using FaceSpan 

List $34.95 Our Price $31 (BAPSCAP) 



The Elements of E-Mail Style 

by Brent Heslop and David Angell 

• Write solid, effective E-Mail and 
avoid common pitfalls. 

Lisf $14.95 Our Price $13.45 (BEMAIU 




Hooked on Java 

by Arthur Van Koff, Sami Shaio, and Orca Starbuck 

• Written by the Java development team at Sun Microsystems. Inc. 

• An introduction to using applets, tor Web administrators, designers, 
and developers. 

• Demonstrates how to use applets in your own pages. 

■ includes a concise introduction 

to the Java language, and a CD with tools. 

List $29.95 Our Price $26.95 (BHJAVA) 


Java in a Nutshell 

by David Flanagan 

• A complete quick reference guide to Java, the hot new programming 
language from SunMicrosystems. 

• Contains descriptions of all of the classes in the Java 1.0 API. with a 
definitive listing of all methods and variables. 

• Also contains an accelerated introduction to Java for C and C+-h 
programmers who want to learn the language fast. 

List $14.95 Our price $13.45 ®JAVA!CIT) 



Web site: http://www.devclepot.com • E-mail: orders@devdepot.com 





















Planning and 
Managing Websites 

by Jon Weiderspan and Chuck Shotton 

• The definitive guide to setting up and 
running a Web site on the Macintosh. 

• Learn everything you need to know about 
using WebSTAR, the best known HTTP server 
software and its shareware 
predecessor MacHTTP. 

• Write CGi applications for your server - in 
AppleScript and in C. 

• CD includes a special version of 
WebSTAR. plus tons of useful software. 

List $39.95 Our Price 35.96 (BPLANWEB) 


Mac OS 8 Revealed 

by Tony Francis 

• The first authoritative look at this exciting new operating system. 

• A must for Mac developers who want to make their software 
compatible with Mac OS 8. 

• Essential for system administrators who plan to upgrade their system. 

• Included CD-ROM contains demos of new Mac OS 6 features. 

List; $34.95 Our Price: $31.45 (BMAC0S8R) 
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Teach Yourself Java for 
Macintosh in 21 Days 

by Laura Lemay and Charles L. Perkins 
with Timothy Webster 

• Add interactivity and multimedia to Web 
pages! 

• A step-by-step guide to make your Web 
site come alive. 

• Learn the basics of programming Java applets and the con¬ 
cepts behind the Java language. 

• Includes CD-ROM wiPr a limited version of Roaster, the first 
commercial, integrated applet development environment for 
Java for the Macintosh! 

List $40 Our price $36 (BJAVAMAQ 


JavaScript for 
the Macintosh 

by Matt Shobe 
and Tim Ritchey 


• Allows non-program¬ 
mers to take advantage 
of the power of 
Netscape Navigator. 

• Expand the capabilities of your Web page, 
without having to understand C or C+-I-. 

• CD-ROM contains “WKtets" that allows you 
to easily create your own JavaScripts 

• Takes you step-by-step through programming 
cross-platform JavaScripts 

• Details how to create JavaScripts tor 
JavaScript-aware Web browsers 

List $45 Our price $40.50 (IklAVASCRPTJ) 


JavaScript 




























Leam C on The Macintosh Second Edition 

By Dave Mark 

• New revised edition. 

• Easy-to-under$tand - everything you need to start programming! 

• Updated and enhanced exercises that lead you step by step. You'll learn function, vari¬ 
ables, pointers datatypes, data structures, file input and output and morel 

• Includes CO-ROM willi Metrowerks CodeWarrior™ Lite - the hottest Macintosh program¬ 
ming environment (including a PowerPC version). 

Ust $34.95 Our Price $ 31.45 (BLEARNC2) 


CodeWarrior Software Development Using PowerPlant 

by Jan L Harrington 

• C-H- programmers will learn to develop object-oriented software applications for the 
Mac and Power Mac using Itie PowerPlant environment and the classes that support it. 

• Covers CodeWarrior 8. • Included CO-ROM contains source code for all the pro¬ 
gramming examples in the book and Metrowerks CodeWarrior Lite. 

Ust Price: $34.95 Our Price: $ 31.45 (BCWSWDEV) 

Designing Animation for the Web 

by Hayden Development Team 

• Provides technical information and design advice for creating animalion on the web 

• Expert tips show which technology to use for specific needs: GIF animation, Shockwave, Java and more. 

• Covers bandwidth considerations and the integration of animations Into overall site design. 

• Step-by-step instructions. 

• CD-ROM Includes tools, scripts, and examples for creating animations. 

List $40 Our Price $36 (BOAFTW) 



CGI By Example 

by Jeffrey Dwight 

• CD-ROM contains all the code and tools used in the 
book, and additional tools and examples, as well as 
related chapters from Special Edition Using CGI and 
Special Edition JavaScript 

• Includes end of the chapter review questions and 
exercises to reinforce the learning process 

• Covers basic CGI applications, as well as advanced 
topics like server administration Issues and database 
connectivity 

List $34.99 Our Price $ 31.45 (SSGIBE) 


{ OPTIMIZING 
CODE 



Perl Quick Reference 

by Michael 0. Foghiu 

• Commands are sorted by task, class packet, platform or 
hardware compatability all in alphabetical order 

• includes jump te^les to guide reader to specific pages in 
the reference 

• Designed in a larger trim size than traditional Quick 
References-and with a lay-flat binding 

List $19.99 Our Price $ 17.99 (BPERLREF) 


Optimizing PowerPC Code: 
Programming the PowerPC in 
Assembly Language 

by Gary Kacmarcik 

• Take full advantage of the potential of the PowerPC by mas¬ 
tering the Assembly Language techniques. 

• Leam to produce faster more robust software! 

List $39.95 Our Price $ 35.96 (BOPTPPC) 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 









Macintosh C Programming Primer Volume 1 

Second Edition, inside the Toolbox Using THINK C by Dave Mark and Cartwright Reed 

• Updated new edition of the Macintosh programming best seller, 

• System 7, new versions of THiNK C and ResEdit, 

• Learn how to use the resources, Macintosh Tooibox and interface to create stand-alone application 

• 672 pages. 

List $26.95 Our Price $24.25 (BCPRIM1) 

Macintosh C Programming Primer Volume II 

Mastering the Tooibox Using THINK C by Dave Mark 

• Covers advanced topics such as: Color QuickDraw, THINK Class Library, TexEdit, and fine 
Memory Manager: 528 pgs. 

List $26.95 Our Price $24.25 (BCPRIM2) 




Learn C++ on the Macintosh 

by Dave Mark 

• Basic syntax of C++ and object programming. 

• Learn how to write, edit, and compile your first C++ programs. 

• Features key C++ concepts such as derived classes, operator overloading, iostream functions and more. 

• Includes a special version of Symantec C++ for Macintosh. Book/disk package with 3.5" 800K Macintosh 
disk. 400 pages. 

List $36.95 Our Price $33.26 (BLRNCPP) 

SEE RELATED CATEGORY: Dev. Environments 

Macintosh Pascal Programming Primer Volume I 

Inside the Toolbox Using THINK Pascal 
by Dave Mark and Cartwright Reed 

This tutorial shows programmers new to the Macintosh how to use the Toolbox 
resources, and the Macintosh interface to creafe stand-alone applications with 
Symantec's THINK Pascal, 544 pages. 

List $26.95 Our Price $24.25 (BPASCPRI) 




Order Toll-free 
800-MACDEV.1 

■■®)W22-338I) 


Power Macintosh Programming Starter Kit 

by Tom Thompson 

• Enter the world of the PowerPC chips, 

• Get the scoop on the microprocessors, the RISC architecture, and how to write 
native code and emulation operations to create software for the Macintosh PowerPC. 

• CD-ROM includes a unique compiler for writing code easily, 

List $39.95 Our Price $35.10 (BPPCSTARt) 

SEE RELATED CAfEGORY: Dev. Environments 

Macintosh Programming Secrets 2nd edition 

By Scott Knaster and Keith Rollin 

• Macintosh Programming Secrets Is divided in two parts. 

Part 1: "Concepts and Ideas", discusses the evolution of the Macintosh and the standards, 
customs, and software that shape the system as well as the Macintosh user interface, 

Part 2: “Technical Adventures", presents the skeleton of an application, and then builds upon 
that framework to describe how to: • Create fancy dialogue boxes • Utilize the new 32 bit 
QuickDraw developments • Track the mouse with “marching ants" • Manage multiple windows 
with the Window manager • Copy files within a program • Install the worlds 
strangest spinning cursor. 

List $31.95 Our Price $28.76 (BPSECRET) 
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Cjfberdog Programmer’s Kit 
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A Fragment of Your Imagination 

by Joe Zobkiw 

• Packed with useful code fragments for the Macintosh and Power Macintosh. 

• Hard to find information about techniques used to structure 
and buiid fat, safe fat, and accelerated code resources. 

• All code is reusable and is provided on the disc, along with 
Melrowerka 

Code Warrior Lite. Book/CD-ROM, 528 pages. 

List $39.95 Our Price $35.96 (BFRAG) 


Web site; http://www.devdepot.com • E-mail: orders@devdepot.com 


Cyberdog Programmers Kit 

by Apple Computer, Inc. 

• Apple's official reference. 

• A must for developers who want to make customiiiable Internet access 
available to all Mac users. 

• Included CD-ROM contains all the tools needed to create Cyberdog-aware 
components. 

List: $39.95 Our Price: $34.95 (BCYBERDOG) 


Java Language APi SuperBibie 

by Daniel Groner, Todd Sundtsed, 

Casey Hopson, Harish Prabandham 

• Covers Java 1.1 

• Hundreds of concrete source code examples provided 

• Sample projects introduced and assembled in each chapter 
List $59,99 Our price $53.99 (BJLAS) 


Programming with AppieTaik 

by Michael Pierce 

• Programming with AppleTalk is the hands-on guide to understand¬ 
ing and working with AppleTalk. Topics covered include: 

• How to create applications and system extensions that run with 
AppleTalk, 

• AppleTalk protocols and the protocol stack, transport media, the 
Preferred AppleTalk Intefrace, and the storage management, 

• Numerous working code examples walk you through using RDEV, 
INIT, NBP, ATP, and ADSP. You will also learn the use of: 
Synchronous, and asynchronous calls, How to avoid heap frag¬ 
mentation, And how to configure a Chooser Interface. 

List $24.95 Our Price $22.45 (BPROAT) 


infini-D Revealed 

by Brendan Donahoe S Adam Lavine 

• CD-ROM includes a demo version of tnfini-D 
3,1, files for working through the tutorials, 
and a gallery of spectacular 3D images 

• Shows how to use the new animation fea¬ 
tures to bring images to life 

• Details Infini-D's new and improved color- 
coded interface 

List $45 Our price $40.50 (SINFDREV) 


NetObjects Fusion Handbook 

from Hayden Development Team 

• Create Web pages and Sites through design tectiniques 
developed by Clement Mok’s design agency. 

• Step-by-step instructions on updating sites with links 
and navigational controls automatically. 

• Outlines the comprehensive steps to delivering an auto¬ 
mated, turnkey Web publishing solution. 

• CD-ROM contains a 45 day time-limited version of 
NetObjects Fusion. 

List $50 Our Price $45 (BNETOFH) 
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AppleScript Language Guide, 

by Apple Computer, Inc. 

• A complete reference for anyone using AppleScript to modify existing 
scripts or to write new ones. 

• Contains useful information tor programmers who are working on 
scriptable applications or complex scripts. 

• Features detailed definitions of AppleScript terminology and syntax in 
the following categories; Value classes, commands, objects and ref* 
erences to objects, expressions, control statements, handlers, and 
script objects. 

• Includes many sample scripts, discusses advanced topics such as 
writing command handlers for script applications, the scope of script 
variables and properties declared at different levels in a script, and 
inheritance and delegation among script objects. 

List $29.95 Our Price $26.95 (BALG) 

SEE RELATED CATEGORY; Scripting 


Danny Goodman’s AppleScript Handbook 

Second Edition by Danny Goodman 

• Custombe and extend the capabilities of any Macintosh computer - no 
programming experience needed! 

• Learn to use scripts to enhance the Macintcsh environment, automate many 
processes, link data between applications, and much more. 

• All-new examples showing how lo integrate AppleScript with the Finder, 
spreadsheets, desktop publishing programs, graphics applications, databases, 
telecommunications programs, utilWes. and HyperCard. 

• Includes 3'/?" disk with over $100 worth of software, including 
AppleScript 1.1, valuable utilities, and powerful, ready-to-use scripts. 

List $39 Our Price $35 (BOGASHB) 

SEE RELATED CATEGORY: Scripting. Tools. Ubs & Utilities 


Applied Mac Scripting 

by Tom Trinko 

• Learn to design and develop powerful scripts. 

• Covets AppleScript*^, Frontier, QuicKeys, Tempo II, n&iell, 
FaceSpan Application Builder. Scripting PlainTalk and System 
7.5. 

• Hands on tutorial shows you how to automate your 
Macintosh activities by learning how to use the AppleScript 
and Frontier scripting environments. 


• Harness the capabilities of a wide variety of Macintosh 
applications into the integrated productivity tools. This 
includes such things as the newspaper script which com¬ 
bines the power of SITcomm, MacWrite Pro. and FileMaker 
Pro, or QuarkXPress. 

List $34.95 Our Price $31.45 (WRUED) 

SEE RELATED CATEGORY: Scripting 
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AppleScript Finder Guide, 
English Dialect 

by Apple Computer, Inc. 

• Provides definitions for Finder object ciasses 
and commands. 

• Write, record, or mn scripts that trigger the 
same desktop actions that you trigger using the 
keyboard and mouse. 

List $19,95 Our Price $17.95 ^G) 

SEE RELATED CATEGORY: Scripting 


AppleScript Scripting 
Additions Guide 

by Appie Computer, Inc. 

• Use the standard scripting additions commands. 

• Write scripting additions. 

List $18.95 Our Price $17.05 (BSCRADD) 
SEE RELATED CATEGORY: Scripting 


















PowerPC Programmer’s Toolkit 

by Tom Thompson 

• CD-ROM includes a special version of Metrowerks CodeWarrior 7.0 and sample code from 
Ihe book 

• Details how to write PowerPC applications in native code for blazing speed 

• Written by an Apple insider 

List $45 Our Price $40.50 (SPPCPT) 


PowerPC 
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Toolkit 
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Mastering Netscape 2.0 for Macintosh, Second 

Edition by Greg Holden 

• CD-ROM includes Netscape Plug-Ins and helper applications 

• Uncovers hidden features of the program and how to best utilize them 

• Web page for liie t)ook includes cool utilities and updated information 

List $40 Our Price $36 (SMASNET4) 
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Network Frontiers Bundle 

byAP PROFESSIONAL 

(Includes 3 books: Complete Guide to 
MAC,Backup Management, Designing AppleTalk 
Network Architectures, Managing AppleShare 
and Wwkgroup Servers) 

• Apple Certified 

• Each bundle includes the first 3 books 
that correspond to the Apple 

• Certified Server Engineer (ACSE) program 

List $89,95 Our Price $59.95 (BNETFB) 



Object Oriented Program Design 

by Mark Mullin 

• A concise guide to the essential concepts and techniques of OOP design 

• Clarifies the key concepts of object oriented programming such as objects, classes, 
entities, hierarchies, and Inheritance 

• Uses typical database application to illustrate each OOP topic, to give the programmer a 
familiar point of reference 

List $22.95 Our Price $20.66 (BOOPRODES) 


Intranet Web Development: Enterprise Alternatives to 
Client/server Computing by Hayden Development Team 

• Learn why traditional client/server computing is being replaced by new 
WWW technologies. 

• Discusses WWW application development with the Microsoft Visual 
Script enterprise application developer in mind, 

• Learn techniques for the conversion of existing Visual Basic, C+-r and 
PowerBuilder Applications to the new WWW platform, 

List $49.99 Our Price $45 (BINTWD) 



DeBabelizer: Tbe 
Authorized Edition 

by Hayden Development Team 

• Teaches effective ways to utilize DeBabelizer to 
improve graphic's quality and speed. 

• Offers techniques for using SuperPallette to opti¬ 
mize Images. 

• Provides extensive visual examples to illustrate key 
production techniques in all areas of graphics pro¬ 
cessing. 

• CD-ROM includes the Lite version as well as 
Photoshop plug-ins. 

List $45 Our Price $40.50 (BOEBTAE) 


Tog on Software Design 

by Bruce “Tog" Tognazzini 

Respected Industry futurist, Tog, presents his vision of our technological 
future, detailing the steps computer professionals need to take to deliv¬ 
er new technologies that will profit the industry and benefit society in 
general, Contains Tog’s insights on a wide range of topics from quality 
management to the meaning of starrdards. and responses to queries 
supplied by designers and developers. 

list $29.95 Our Price $26.95 (BTOG) 


Web sife: http://www.devdepot.com • E-mail: orders@devdepot.com 
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3D Graphics Programming 
Using QuickDraw 3D 

by Apple Computer, Inc. 



• Incorporate spectacular 3D graphics into your applications. 

• Bcptare QuickDraw 3D. a revolutionary graphics extension to 
the Mac OS for Power Macintoshes. 

• CD contains the complete QuickDraw 3D system itself and a 
complete database ol the QuickDraw 3D API, allowing you 
instant access to the hundreds of graphics calls via a fast 
viewing engine. Book/CD-ROM, 640 pages. 

List $39.95 Our Price $35.96 (B3DGRAP) 




Sex, Lies and Video Games 

by Bill Hensler 

• A learn-by-example tutorial on the ins and ouls 
of Mac arcade-style game programming in C. 

- Features game theory, sprite animation, sound, 
and interaction techniques. 

• A must-read for serious programmer’s and 
ttobbyists alike. 

List 34.95 Our Price $31.46 (BSEX) 

SEE RBATEO CATEGORY: Tools. Libs & Utilittes 




li’icks of The Mac Game 
Programming Gurus 

by McCornack, Ragnemalm, Celestin, et at. 

• For beginning to expert game programmers 

• Complete overview of all the necessary com¬ 
ponents of game programming on the 
Macintosh. 

• Packed with valuable tools, utilities, sample 
code, CodeWarrior™ Lite and game demos. 

• QuickDraw 3D and Power Mac optimization 
and inside info on how Glypha III was created. 

• Hundreds of tried-and-true tricks, tips, and 
insider secrets trom well-known Mac game 
programming experts 

List $50 Our Price $45 (BTRICKS) 


3D Graphics-rips, 

Tricks, & Techniques 

by David Kalwick 

• Written from a user's point-of-view, this 
book covers all the important 3D technique 
including lighting, textores, animation, cam 
era angles, and perspectives. 

• Through easy-lo understand examples you' 
learn how to create high-quality 3D graph¬ 
ics. 

• Includes a Windows/Macintosh CD-ROM 
featuring tutorials, 30 examples from the 
book, and more. 

List 34.95 Our Price $31.46 (B30Gfn 


Biack Art of Macintosh Game Programming 

by Kevin Tieskoetter 

• Develop your own 30 games in C on the Mac. 

• Includes CD with project files for both Symantec C and Code Warrior 

• Create freeform texture-mapped games and polygon graphics 

• Control dynamic source code-ail compatible as native to the Power 
Mac 

• Write directly to the screen, bypassing QuickDraw 
List $39.99 Our price $35.99 (BBUCK) 
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Graphic Gems V Edited by Alan W. Paetb 

• Loaded with practical tools for implementing 
new ideas and techniques, to offer working solu¬ 
tions to real programming problems. 

• Contains over 40 new gems in ellipses, splines. 
Bezier curves, and ray tracing - displaying the 
most recent and innovative techniques in graphics 
programming. 

• Includes a disk with source code from all five vol¬ 
umes. Available in both IBM and Macintosh ver¬ 
sions, COMTENTS: Algebra and Arithmetic. 
Computational Geometry. Modeling and Trans¬ 
formation. Curves and Surfaces. Ray Tracing and 
Radlosity. Halftoning and Image Processing. 
Iftilities. 

List $49.95 Our Price $44.95 (BGEMS5) 
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AppleGuide Complete 

by Apple Computer, Inc. 

• Covers Guide Maker, the software you use 
to build and test guide files. 

• Learn about the complete cycle of design¬ 
ing as well as advanced topics such as 
scripting and coding guide tiles. BocHt/CD- 
ROM, 544 pages. 

List $39.95 Our Price $35.96 
(BAPLGD) 

SEE REUTED CATEGORY: Tools. Libs & Utilities 



Advanced Color Imaging 
on the Mac OS 

by Apple Computer, Inc. 

• Enhance your software's color capabilities 
with step-by-step instructions. 

• Augment the color support supplied with 
QuickDraw, and QuickDraw GX. 

• Use the Pailette Manager to get the best 
colors on limited displays. 

• Match colors between screens and 
input/output devices (scanners & printers) 

• CD includes a complete reference infor¬ 
mation in both QuickView and Acrobat 
formats. Plus, a sample application 
demonstrating ColorSync programming 
techniques. 

List $36.95 Our Price $33.25 (BAUVCI) 



IpenDoc Programmer’s Cookbook by Apple computer, me. 

' Shows you how to create OpenOoc software components, called parts editors, for the Mac OS Platform. 
' Including instructions for setting up the Macintosh Programmers Workshop (MPW) development 
environment to write OpenOoc software 

' Annotated listings of explaining the methods that implement the SamplePart part editor 
> Descriptions of other sample part editors created by the OpenDoc engineering team to illustrate 
more advanced features 

• Summary descriptions of software utilities provided with OpenDoc for the Mac OS 
»An Introduction to the System Object Model (SOM) technology underlying OpenDoc 

List $24,95 Our price BODCOOK) 



aside PowerPlant Manual 

jy Metrowerks 

• Create PowerPlant applications using the 
CodeWarrior IDE and PowerPlant Constructor. 

• Full descriphons ot major PowerPlant classes and 
resources. 

■ Included are the PowerPlant Constructor Manual, 
including View, TextTraits and Custom Types edit¬ 
ing, and PowerPlant Library Reference, covering 
all classes and functions in PowerPlant. 

Our Price $34.95 Bitepp) 

SEE RELATED CATEGORY; Dev. Environment 


RAEdit 

Complete 

tVkr Strmift 


ResEdit Complete, 

Second Edition 

by Peter Alley and Carolyn Strange 

• Customize every aspect of your interface form 
creating screen backgrounds and icons to cus¬ 
tomizing menus and dialog boxes. 608 pages. 
Book/disk package. 

List $34.95 Our Price $31.45 (BRESED2) 



Web site: http://www.devdepot.com 




• E-mail: orders@devdepot.com 
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C++ Programming with CodeWarrior 

by Jan L. Harrington 

• Beginning OOP for the Macintosh and Power Macintosh and Mac OS 
compatibies. 

• Learn object-oriented programming techniques using C++ as the exam- 
pie language and Metrowerte and CodeWarrior as the example compiler. 

• Enclosed CD contains example code from the book and a full-function 
Metrowerks CodeWarrior 

List $35.95 Our Price $32.35 (BCPPCW) 




OpenDoc Programmer’s Guide 

by Apple Computer, Inc. 

* The official reference for the implementation of OpenDoc on the Mac OS. • Describes the component software revo¬ 
lution and explains how to develop for It on the Mac OS platform. • Accompanying CD-ROM contains a complete refer¬ 
ence to the OpenDoc programming interface, and an extensive collection of tested, reusable sample code. 

List $44.95 Our Price $40.46 (BOPENDOC) 


The ResEdit Ali Night Diner 

by David Ciskowski 


• An idea-filled menu and Introduction to the joys of customizing software, 

■ Add personality to the Mac by customizing default icons, the text of menus and dialog 
boxes, cursors, pointers and more. 

• Disk features ResEdit, plus lots of sample resources 

List $24,95 Our Price $22.45 (BRESDIME) 




SEE RELATED CATEGORY: Dev, Environments 


C++ Programming with MacApp 

by David Wilson, Larry Rosenstein & Dan Shafer 

• Learn the secrets to unlocking the power of MacApp^, Apple's development envi¬ 
ronment for C++ 

• Learn to design complex windows and views using the ViewEdit tool 

• Learn to support multipage text and graphics with only five lines of code 

• Learn to support Undo for menu commands and drawing operations lhat use the 
mouse. 

List $34.95 Our Price $31.46 (BCPPMACAP) 

SEE RELATED CAtEGORY: Tools, Libs & Utilities 



Essentiai OpenDoc 

by Jesse Feiler and Anthony Meadow 

• Gives an in-depth look at the technical issues of OpenDoc 

• Explores the three core technologies that support it's 
functionality - SOM, OpenDoc's storage mechanism, and 
the Open Scripting Architecture (OSA). 

• Also examines CyberOog, a set of OpenDoc part editors that 
provides access to Internet services and offers compelling 
example of the power of OpenDoc development 

List $39.95 Our price $35.95 (BESOD) 


Inside CodeWarrior 10 

by Metrowerks 

• Includes CodeWarrior IDE User’s Guide. 

• This is the printed version of the 
documentation provided on the CD. 

• Covers CodeWarrior, the debugger, and 
associated tools. 

Our Price $34.95 (BiNSCW) 

SEE RELATED CATEGORY: Dev. Environment 
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Metrowerks CodeWarrior Pragramming 

by Dan Parks Sydow 

• Includes CodeWarrior Lite, and Full Coverage of PowetPtant '“. 

• The best information on Metrowerks CodeWarrior, giving full coverage to the Gold Edition. 

• CD includes Code Warrior Lite. 

List $39.95 Our Price $35.95 (BCWPR06) 


Order Ml-free 
OOOdUOEV'l 




Visual Programming with Prograph CPX 

by Scott B. Steinman and Kevin G. Carver 


• An tnfroduction to the language and a guide for advanced users, for both 
Macintosh and Windows-based machines. 

List $34 Our Price $30.60 (BVISPRO) 

SEF RFLATEO CATEGORY: Dev. Environments 


The Power of Prograph CPX 

by Dan Shafer 

• Master the revolutionary graphical object-oriented programming language. 

• Step by step course through three interrelated projects of increasing complexity. 

• Learn Prograph language, CPX classes and object editors. 

• Includes disk with ail code in the book. 

List $49.95 Our Price $19.95 (BDANPRO) 




Mastering the THINK Class Library 

by Richard Parker 

• Provides a thorough examination of Symantec’s extensive Class Library and the 
Visual Architect. 

• A complete description of the structure and operation of the TCL includes explanatms 
of all code generated by the Visual Architect, any necessary custom code, and the 
operation of this code. 

• Visual Architect tutorials provide you with a step-by-step approach for simplifying the 
development of complex Macintosh applications. 496 pages. 

List $29.95 Our Price $26.95 (BMASTERTCg 
SEE RELATED CATEGORY: Dev. Environments 


Danny Goodman’s Apple Guide Starter Kit 

by Danny Goodman and Jeremy Joan Hewes 

• Create your own Apple Guide databases quickly and easily, without having to learn a 
scripting language, write coded files, or use several different files and programs 

• Includes advice and tips on how to design a good Guide, from planning and creation 
through testing, revising, and indexing. Book/disk. 320 pages. 

List $34.95 Our Price $31.46 (BDGAGSK) 



MacsBug Reference & Debugging Guide For MacsBug version 6.2 
by Apple Computer, Inc. 

• MacsBug is an assembly-language-ievel debugging tool • Macros, templates, dcmds, and other resources for 
making debugging easier • Macintosh memory management and the operating system as they relate to low level 
debugging • How to display and set memory and process registers • Dissssemble memory, and set execution 
breakpoints • Discipline, a tool for testing the validity of toolbox parameters • Debugging strategies you can use to 
find and cure common bugs • Includes MacsBug 6.2. 

List $34.95 Our Price $31.46 (BBUGREF) 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 




















Netscape Navigator 3.0 

by Bryan Pfaffenberger 

• Learn the best Web surfing techniques. 

• Quickly find your way to valuabie information on the Web. 

• Learn to use the new plug-in tools, including Live3D and Real Audio, 

• Send and receive electronic mail to anyone on the Internet. 

• Utilize the enhanced security features for on-line shopping and ordering. 

List $29.95 Our Price $26.96 (BNETN3) 


Web Page Scripting Techniques by MacMillan 

• Manipulating color effectively 

• Placing images and using shapes 

• Using JavaScript functions and objects, plus VBScript functions and objects 

• Determining users’ browser type and operating system 

List $50 Our Price $45 (BWEBPST) 
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-800-MACDEV-l • Outside U.S. & Canada: 805-494-9797 • Fax: 805-494-9798 


Netsca^ 

Navigator 

StararKit 


Netscape Navigator Starter Kit for Macintosh by MacMillan 

• Create your own home page in minutes and add hyperlinks to your favorite Web sites 

• Add graphics, audio, and video 

• Download files via FTP 

• Load plug-ins to enable movies, audio, animations, and more 
List $34.99 Our Price $31.49 (BNETNSK) 


Web Page 




Programming For The Newton; Software 
Development using NewtonScript 

by Julie McKeehan and Neil Rhodes. Foreword by Walter R. Smith 

• An indispensable tool for Newton programmers, • Includes disk with 
sample Newton application from the books, as well as demonstration 
version of Newton Toolkit (NTK) - the complete development environ¬ 
ment for the Newton^, • A Publication of AP Professional May 1994, 
Paperback, 393 pp. 

Ust $29.95 Our Price $26.95 (BPROGNEWT) 

SEE RELATED CATEGORY: Dev. Environments 


BASIC for the Newton 

by John Schettino & Liz O’Hara 

• Program on Macintosh, Windows-based PC. or on the 
Newton itself. 

• Straight-fonward “programming by example" approach 
- you'll be writing Newton programs right away, 

• Includes 3.5" disk containing Demonstration NS BASIC 
and over fifty example programs. (Newton not included) 
List $35.95 Our Price $32.35 (BNEWT) 

SEE RELATED CATEGORY: Dev. Environments 
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Building and Maintaining 
an Intranet with the Macintosh 

by Tobin Anthony 

• Set up services such as video conferencing, Real 
Audio, message boards, employee scheduling, e-mail, 
WWW, ftp, and many more. 

• Find a simple, cost-effective solution to providing cor¬ 
porate information to company employees. 

• Learn how to open portions of your intranet site up to 
the internet while keeping private information safe. 

• Companion CD-ROM. 

List $50 Our Price $45.00 (8BAMAI) 























Internet Publishing with Adobe Acrobat 

by MacMillan 

• Optimizing PDF for Web viewing, integrating HTML and PDF, 
selecting PDF page dimensions, PDF file evaluation 

• Setting iinks to PDFs and URLs, PDF forms, Security algorithms. 
Configuring Web servers for PDF, Embedded PDFs, PDF creafion 
techniques. 

List $40 Our Price $36 (BIPWAA) 


Order Toll-free 
800-MACDIV-l 

#6622-338Ij 


^ on the Mac 

by Barry Boone with Dave Mark 

• Easy-to-follow introduction for beginning 
programmers and Webmasters. 

• Takes you through the core concepts of 
Java. 

• Includes: Object-oriented techniques, 
unique features such as garbage coilection, 
and basic programming concepts such as 
working with variables, threads and classes. 

• Learn to apply this knowledge lo write original Java applets for Web 
pages. 

• Includes CD-ROM 

List: $34.95 Our Price: $31.45 (BLJAVA), 
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Macintosh 


Providing Internet Services 
via the MacOS 



by Carl Steadman and Jason Snell 
• Shows you how to provide Web pages, FTP, Gopher, 
e-mail, and more with the Mac OS, 

■ Includes CD-ROM containing all the Mac server 
software and utilities you need. 

List: $34,95 Our Price: $31.46 (BPROVNET). 


Learn HTML on the Mac 

by Dave Mar1( and David Lawrence 

• Shows you how to use HTML 3,0. 

• Included CD-ROM contains Macintosh tools to 
design stunning multimedia Web pages. 

List: $29.95 Our Price; $26.95 {BLHTML) 
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Hardware 

CODE 

PRICE 

ilfi.Scnpif Ap?)lteaiiOns: Dutidiog Apflficaiiofei wyFaoeSpan 

BAPSCAP 

S3t.45 

Apple CD HUM HariLiltixjK 

BUUtiAND 

14^ 

jic Inr the Newton - Programming using NS BA5yO 

BNEWl 

32.35 

Designing Cards & Drivers lor tlHi Macimesh 

BOARD 

26.96 

+ PrEKjrartirTHftg wrfh CodeWarnor 

BCPPCW 

32.35 

1 aserWnlBr rtefenance 

BLASLRREF 

17.96 

-L PrugrHUirinng with MacApp 

RCPPMACAP 

31.46 

PCI Ejfstem Arthitecture 3rd Edition 

BPCtSYS 

31.46 

;+-»-SOK User’s Guide 

RCmiSfR 

29.00 

PowerPC J^m Archltecti^e 

BPPCARCH 

31.46 

jeWarrior liBicte PtiwerPlanr 

BINSPP 

34.95 




jeWamof Soltware DtrwiJlnpfnenr esing PowerPteinl 

BCWJWDFV 

31.45 

Internet Related 



1 Shafer Presoils ttiu Power of Prugraph CPX 

BOANPRO 

19.95 

1U94 Intofnet Wtiite Pages 

BfHWHFTE 

26,95 

ITTWJ SOK users Gukte 

BFOmUSEB 

34.95 

Active Java 

BACTIAVA 

23.36 

tde CodeWt^hor \kjck 

flJNSCW 

34.95 

America Oniftc for Dummies 

BAOLDtJW 

17.95 

Reson Programmers Lditori 

EJLSIHSHT 

74.95 

OGl By Dtampie 

BCGfBE 

31*45 

irn C on the Macintosh, lind bdltion 

0L£/tftNC2 

31.45 

computer Privaev 1 laiidbook 

BPRIV 

22.45 

sieriiig theThinit Class Librarv 

BMASTLHICL 

26.95 

F-Maii Essentiats 

BLMAILE 

22.45 

IrovMks GoriaWarrior f^ogrammina 

BCWPROG 

35.95 

plements of E-Mal Style 

BLMAIL 

13.45 

iGcMting Magtr: Cap 

BPREEMAG3C 

15.25 

Hooked on Java 

BHJAVA 

26*95 

igramrfling lof Ifie Newino Using NewtonJiaiipt 

BPftf)GfWr 

26.95 

Instoot toiemet Guide 

BlNSTANf 

13*45 

3l World Apple GuidK 

eflEAiwin 

35.95 

tritomel Bonk 

BTHENET 

22.50 

nofltcc Prograrnmrng 

fiSYMCPP 

39.50 

Iritemel tor Oummies Pod Edition 

BNFTTKJM2 

17.99 

igeol s titridc to Deagning Progcarns 

RTALIGEMT 

17.55 

Internet for Onmmifis Quick Reference 

BDUMOCK 

6.05 

iial ProgremmitJO wiUi ftogmiilr 

BVtSPRO 

30.60 

tnicfnct lor Macs for Diimmi^ 

BNFmifM 

17.95 

eiess For 1 he Newton 

aWlfl£L£SS 

31.45 

IntefiiGi lur Macs \vt Dummies Bestseller Edition 

BlFMFDflE 

35.99 
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imemer Power Tools 

BPWfTTOa 

36.00 

Madniosh C Programmer pnmer Vplume i 

BCPHIMt 

24.26 

imemet PuWisJilng with Adobe Aoobai 

BIPWAA 

36.00 

Macintosh C Programmer Primer Volume 2 

BCPRIMZ 

24.25 

imemsf Secrets 

BSECRET 

35.99 

Macintosh 01L2 Prog. Reference Working witti Ohfecis 

BaE2 

40.45 

liTtefnei, The, Deluxe Editiot] 

BNFTDaUK 

31.50 

Macinlosh Pascal Programming Piiiner Vblurne 1 

BPASCRRI 

24.25 

Intranet ^ Dev.: Enlorpnse AHofnattves to Qiertt/Servef 

BtNTWD 

44.99 

Manntosh Programming Secrets 

BRSFCRET 

26.76 

Java Esaenlials lor C/C++ Progranimefs 

B-IAVAESSEN 

17.96 

Macinlosh Programming Techniques 

BPTFCH 

31.95 

Java in a Nitlsiioil 

BJAVANLfT 

1145 

More Mac program mlng Technkiues 

BMORETECH 

34.5t 

Java Language API Super^tble 

BJLAS 

53.99 

Network Fromtem Bundle 

BNETFB 

59.9f 

JavaSedpt for Machtosb 

BJAVASCRPT 

40.50 

Newtnn PrngraitiiTiiny GubejQ 

BNEWTPGUfD 

40 

Leam HTML on the Macintosh 

BUITML 

26.96 

Obfed Ortenled PmQfamming Design 

BOOPHODtS 

20.6E 

Leam Java on the Maemrosh 

BUAVA 

31.45 

OptiinL^tg PowerPC Code 

BOPTPPC 

mm 

Mastenng NetScape 4.0 for MannttK^h. SecumI Edition 

BMASlCr4 

36.00 

PdslScnpl Language Kelerence 

BPSLANREF 

29 GE 

Mom Internet for Dumiates Starter KiL 

BOUMNET 

17.^ 

Power Macintosh Programming Starter Kit 

UPPCSTABT 

35.1t 

Mosaic for DummiHs 

BMOSDUM 

17.99 

Poweibook: Digital Nomad's Guide 

BPBTDNG 

22.4L 

Net Chat 

BNETCHAT 

17.00 

PowerPC Programmer's Toofldt 

RPfGPT 

40.5t 

MelObfecls Fuawn Handbook 

BNFTOFH 

45.00 

Programming Introduction In the Mujcinlofih Family 

RFAMIIY 

22.4t 

Netscape Navigator 

BNFTNAV 

26.95 

Programming for System 7 

aSYS7 

2A2i 

Netscape Navigator Slartor Kit 

BNFTNSK 

3t.49 

ProgrammiTH] Primar Madnlosft Volume 1 

BPRIMMAC 

MM 

Ouick Reterenoe 

BPERLFIEF 

17.99 

Programmeng QuickDraw 

BPfiOQORAW 

242? 

Planning and Manafvng WSb sites 

BPIANWEB 

36.96 

Programming Starter lOl 

BmOSTART 

40.fi( 

Providing internet Sarvloes 

BPflOVNhl 

31.46 

Programming willi Appiclali 

BPROAl 

22.4? 

PoMisti it on the Web 

BWEBPua 

31.46 

Quiekrime - onkial Guide lor Macmiosh Usero 

BUIGUOi 

45iK 

TCP/tPVol1-V0l 2 Bundle 

BTCP12DN0L 

99.00 

Oiiickrirne Starter Kit tor the Macinlosh 

BUTSKII 

40.5r 

Teach Vourseir Java In ?1 days 

BJAVAMAC 

36.00 

Fteal World Apple Guide 

BMJtLWlJD 

35.9f 

Undergraund Guido to Tetenommaiing 

BUNDER 

22.45 

BasEditAII Night Dtner 

BHESDtWE 

22.4E 

Web Head Mac Golrie 

BWEBHEAO 

Z2.45 

RosEdil Complete, isi Edition 

Lt«ESED1 

31.4E 

Web Rage Scripliiig Tecluiiques 

BWEBPST 

45.00 

ResEdit Complete, 2nd Editor 

^SED2 

31AE 

Wteb WeavirKj 

BWWFAV 

22.45 

ftesLdit Reference 

©lESFORFF 

26, 

Wbbmasler Macirtlasfi 

BWFBMAS 

26.96 

Software by Design: Cmanng User Friendly Software 

SDFSICN 

2695 




Symantec C* t ter the Macintesh:Tlie Basics 

BSCFTMTB 

31,4f 

Scripting and Solutions 



Teach 'tosetf Macinrnsh C++ in 21 Days 

RCPP210 

26.9! 

AppleSci ipt Awlicaticns Lktildinq Apps with FaceSpan 

BAPSCAP 

31.45 

Technical inirndticfioti to itie Macintosh t amity 

BTTTTMF 

2*21 

Applied J^miosh Scripting 

BAPPUED 

31.4S 

Tog on Software Design 

BTOG 

26.Bf 

Compfoto AppleScript Handbook 

eAPLSCRHB 

31.50 

Wirete's for ttie Newton Development tor Mobil Comm. 

BWIREL£SS 

31.4! 

Complete HyperCard 22 Handbook 

8HYPCBD2 

31.50 

Writing Localizabla Sollware 

BLOCAL 

24.2? 

Danny Goodman's Appie Guide Starter Klf 

BOGAGSK 

31.46 




Danny Goodman's ApfiteScript HaiKteook 

BDGASTB 

35.00 

MisceKaneous 



HyperCard Sladr Design 

BHYPSTA 

19.95 

Atfetje Premiero lor Ihe Madnii^ 

mm 

44.^ 

HyperTalt 22: The Book 

BHVPTAL 

31.50 

Amerk^ Online ter Duimmies 

BAOmUM 

17.9? 

J^Script fer Macintosti 

BJAt/ASCPPT 

40.50 

All ol Human Inteitace Design 

BAHIQ 

29.6? 

Perl Quick Befference 

BPEFILREF 

17 99 

Best ol Maclutor 3.4. b 

BMTBEST 

9.9? 

Real World AtJpfe Guide 

BREALWin 

35.95 

CD ROM Guide 10 Multimedia Auitrariny 

BCOMULTI 

40.4? 

Tao of AppleScript: BMUG's Guide to Macintosh Scripting 

0TAO 

26,95 

CompuServe for Dummies 

RCSDDM 

17.9! 




Creating intaraefive CD-ROM 

RIWTEHCOB 

35.9? 

Technical Reterence 



Cyberpnnk Handbotik 

BCVBPUW 


Active Java 

BACTJAVA 

23.36 

Danny Goodman's Mi«:lnladi Handbook 

BGOODHB 

269! 

Apple CD RDMHondbaok 

BCOHAND 

14.36 

eWorld The F^ssenlial Guido 

BEWORLD 


Art ot Human imerface Design 

BAUD 

29.65 

Frameworks Source Code D^ 

MTFWSC 


filack Art 0* Mac Game Prugrarnmlng 

BBLACK 

35.99 

FrameWarks Magaane Hack issue 

MIIWBACK 

8.« 

C+r Ibf Durnmies 

UCPPOUM 

17.95 

Global Intertace Design 

BGLOBAL 

32.3! 

C tor Dummies M 1 

BCOUM 

17.95 

Graphic Gems 2 

BGEl^ 

44.K 

Develnptno no)tM:l Ortefiled Sodwaro ter the Macintosh 

BOeVOB 

20.06 

Graphic Gems 4 

BGEMS4 

44.9! 

Fsientlal OpenDoo 

GESOO 

35.95 

Graphic Gems V 

B0m$b 

44.9! 

Extending II lo Mac Toolbox 

BFTMT 

22.46 

Infrni-D Revealed 

RtNFDREV 

40.5C 

Foundalkms o1 Macintosh Prograrmning 

BFOUND 

35.96 

Late Nyght with MacHack 

BLATE 

Z6.9! 

Fragment ol loiagination 

BFHAG 

35.96 

Mac Bathroom Readei 

BBATH 

11.7i 

Gddo 10 Macwilosh Software Localization 

BJ.CICALIZ 

24J6 

Mac Screamer. The Ultitnate Macintosh Superoharging Kil 

BSC8EAM 

31,S( 

Guide to Madntesh System 7.5 

BSYS7.5 

22.50 

MadntDsh Crasli Course 

BCBASH 

SfiJ! 

1 low to wnie Macinlosh Software 

BWRIIE 

26.05 

MacTedi Bock tssues 

MTBACKISS 

5.0( 

IrtsKte AppteTatk 

BAP1ALX 

31.45 

Macworld LnUmate Macintosh Book 

BULIMAC 

35 

inside the Macintosh Communlcatiufts Toulbox 

BCOMM 

22.45 

Managkrg AppleShare & Servers 

HMAWS 

26.9E 

LaseiWrtter Reference 

BLASERREF 

17.96 

MADACON '93 CD ROM 

SMADA93 

9.9! 

Leafti C++ on the Macintosli 

BLRNCPP 

33.26 

Multimedia Authoring: Building and Devfitopvig Douumonls 

BMMAOTH 

31.45 

Ijeam C on the Maoinlosfi, I sl Edition 

BLfARICI 

31.45 

Mullimedia Starter Hit for Madniosh 

BMMSTART 

27.00 

t earn 0 on the Macinlosh. 2nd Edition 

Bf£AftNC2 

31.45 

ProTil from Experience 

BPROFTT 

22.45 

Mac Pfograritii^ lor Durwntes 

BMACOUM 

17.95 

Sad Macs, Bombs and Disaslers 

BSADMAC 

22,45 




Sax. Lies & Video Games 

BSFX 

31.46 




Stupid Mac Tridcs 

BSTUPPMAC 

17.95 




The Software Devetoper's S Marketer's Legal Oompanton 

BSDAMLG 

33.26 




Tricks of the Mac Game Gurus 

BTRICKS 

45.00 




Zen and tiie Art of Rosourca Editing 

BZAAOHL 

27.00 
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Behind every good Mac app... 


Every job requires the proper tool. When it 
comes to crafting good code, BBEdit 4.0 is 
the Swiss Army Chainsaw of text editors. 


"If you have to spend time wHh text 
on the Mac, you should use BBedit.” 

-- Mac Week, September 30,1996 


• Compare source files and 

apply differences 

• Open From and Save To FTP 

• Search a nd reploce m ultiple fi les 
using Grep 

• Navigate source files with integ rated 
PopupFuncs^** technology 

• Browse project documents 



Bungie Soflware s Marathon Infinity, created using 



Source code from Marathon Infinity displayed In BBtdit 


...is a great 
text editor. 

k 


BBEdit 4.0 


lacLser 



http://www.barebone$.com/chainsaw 

To order, call 617-778-3100 



Bare Bones Software, Inc. 

P.O. Cox I04B, Bedford, MA 0173(1 * main 617-778-3100 * fax 617-778-3IU 


BBBdtt is A lMdirm.ifk of Bflrv Bon*™ SoFtwan-, Inc All olhnr imdcmArkn arwi tradcmarb are properties sif IhciTmsppctive Holden* fi tW Bate SnClware, lac. 
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CodeWarrior 10 wajs-so popular with developers that we re replacing it. 


The World's Best-Seliing Macintosh* Development Tools 


CodeWarrior 


GoM it for M ac OS 


Blood, 


Sweat 


metrowerks 


Three times per year, every year. We upgrade CodeWarrior Gold, the world’s most popular arid powerful Mac development tool suite, to keep up with the fast 
moving world of Mac developers. Now here’s Version II, our most powerful CodeWarrior yet. More reliable, more versatile, faster and more killer than ever before, 
but just as affordable, It’s a result of your suggestions and our imagination. 

CodeWarrior Gold 1 i - $399 

MW GodeManager 3 - Bring Order to Chaos. 

Save time and money with the latest upgrade of the only cross-platform source code management system for the Mac. MW CotjeManager 3 is based on and 
compatible with Microsoft Visu3lSourceSafe’*4.0a. It works with source files as well as any type of binary tile including graphic, database, library and executable 
files. With an Improved interface and new Administrator application you can manage millions of lines of code [n hundreds of fifes and maintain version control 
with ease, it's an essential tool for the well-equipped CodeWarrior. 

„ MW CodeManaier 3 - $399 

' i: ' "T 


Macvorld 




MacwGii 


num 


For More information Call 1-800-377-5416 








S^tem requirementJt 68020 prwessoror higher, or PowerPC 601 procmw or liiglier. S MB HAM mitilmum, 16 MB RAM recommended, CD-ROM drive r^uirtd for initeliation. 
All trademarhs are the property o1 their respective owners and are hereby recogniied. @1996 MeUewerhs Inc. AJI rights rsservod. 





























